NyameBox：基於 sing-box 的 Qt 代理用戶端

圍繞 sing-box 構建

README 將這個專案標識為 NyameBox，儲存庫元資料將其描述為「The Original NekoBox Rebranded」，並定位為一個基於 Qt 的桌面跨平台圖形介面代理工具。代理引擎是 sing-box，README 對 SagerNet/sing-box 表示了致謝，儲存庫描述還補充說該工具由 sing-box 和 thrift 驅動。README 聲明 Windows 11/10（arm64、x86_64、x86）和 Linux 開箱即用。README 開頭宣佈了 sing-box 命令列模式，並給出 `nekobox_core sing-box --help` 作為取得更多資訊的方式。儲存庫元資料將主要語言列為 C++。

NyameBox、sing-box、nekobox_core sing-box --help、TUN、gvisor、happ:// 是本篇核對的專案記號。這一段的判讀要落在來源明列的介面，而不是把專案名稱當成能力保證。 本節所談的 圍繞 sing-box 構建 應與 NyameBox、sing-box、nekobox_core sing-box --help、TUN、gvisor、happ:// 一起理解：若輸入、輸出或執行條件在 README 中有明確例子，便以例子為準；若只出現在說明、版本紀錄或路線圖，就不能推導成目前預設行為。對照時可記下 qr243vbi-nekobox-deep-analysis、圍繞 sing-box 構建 與本段列出的名稱，讓後續閱讀能回到相同位置。這種逐項對照也能看出文件涵蓋了什麼，以及哪些限制仍沒有答案。

協定覆蓋

README 列出了大量受支援的協定：SOCKS、HTTP(S)、Shadowsocks、Trojan、VMess、VLESS、Hysteria 1、Hysteria 2、TUIC、AnyTLS、ShadowTLS、Mieru、Juicity、TrustTunnel、Naive、Wireguard、AmneziaWG、Tailscale、SSH、Tor、Snell、Custom Outbound、Custom Config、Extra Core 以及鏈式出站。待辦 部分指出，上游 sing-box 不支援的幾個協定已經被加入，包括 mieru、juicity、trusttunnel、vless encryption、xhttp transport、kcp transport、amnezia 和 snell，並指向 qr243vbi/sing-box 這個 sing-box 分支作為核心。README 沒有解釋每個協定在圖形介面中如何設定，也沒有說明哪些協定被認為是穩定的。

NyameBox、sing-box、nekobox_core sing-box --help、TUN、gvisor、happ:// 是本篇核對的專案記號。從 README 的安排來看，這個元件處理的是明確的輸入與輸出關係，使用者可以沿著列出的入口逐步核對。 本節所談的 協定覆蓋 應與 NyameBox、sing-box、nekobox_core sing-box --help、TUN、gvisor、happ:// 一起理解：若輸入、輸出或執行條件在 README 中有明確例子，便以例子為準；若只出現在說明、版本紀錄或路線圖，就不能推導成目前預設行為。對照時可記下 qr243vbi-nekobox-deep-analysis、協定覆蓋 與本段列出的名稱，讓後續閱讀能回到相同位置。這種逐項對照也能看出文件涵蓋了什麼，以及哪些限制仍沒有答案。

訂閱匯入格式

README 描述了對分享連結、出站 JSON 陣列和 v2rayN 連結格式的支援，以及對 Shadowsocks 和 Clash 格式的有限支援。完全 JSON 訂閱支援 sing-box 和 v2rayN 風格設定；匯入的 JSON 設定會保留原有的路由和 DNS 規則，可用於 URL 測試和自動測試，也可與 TUN 模式一起使用。Happ 訂閱連結受支援，包括加密的 `happ://` 連結，也可以透過瀏覽器深連結使用 `nekobox://` 和 `v2raytun://` URL 新增訂閱群組。README 還列出了具體的 JSON 訂閱功能：完整匯入 sing-box 設定並在執行時去除入站、新增本機應用入站；針對 VLESS、VMess、Trojan、Shadowsocks、Hysteria、Hysteria2、TUIC、direct 和 block 出站進行 V2Ray 風格 JSON 轉換；保留完整 JSON 設定的路由規則，包括 TUN 模式下的設定檔專屬直連規則；針對較新 sing-box 版本的 DNS 遷移，包括 fakeip 伺服器轉換；完整的 JSON URL 測試和自動測試；以及從 v2rayN/Happ 風格的 Hysteria v2 JSON 中偵測 Hysteria2。

NyameBox、sing-box、nekobox_core sing-box --help、TUN、gvisor、happ:// 是本篇核對的專案記號。文件沒有替讀者補上環境差異、效能承諾或支援期限，因此這些部分應保留為待確認事項。 本節所談的 訂閱匯入格式 應與 NyameBox、sing-box、nekobox_core sing-box --help、TUN、gvisor、happ:// 一起理解：若輸入、輸出或執行條件在 README 中有明確例子，便以例子為準；若只出現在說明、版本紀錄或路線圖，就不能推導成目前預設行為。對照時可記下 qr243vbi-nekobox-deep-analysis、訂閱匯入格式 與本段列出的名稱，讓後續閱讀能回到相同位置。這種逐項對照也能看出文件涵蓋了什麼，以及哪些限制仍沒有答案。

發行套件管道

README 列出了幾條發行途徑。GitHub Releases 提供可攜 ZIP、Windows 安裝程式和 AppImage，其中 AppImage 支援從 5.6.10 版本開始。軟體包管理器條目包括 Scoop（`scoop bucket add extras` 和 `scoop install extras/nekobox`）、openSUSE（`sudo zypper install -y nekobox`）、FreeBSD（`sudo pkg install -y nekobox`）、ArchlinuxCN（安裝前需要先新增 archlinuxcn 倉庫和金鑰）以及一個 Ubuntu PPA（`sudo add-apt-repository ppa:miamosagernaki/nekobox`）。README 還提供了面向 openSUSE、Mageia、Debian、Raspbian、Ubuntu、openEuler 和 Arch 的 OBS 倉庫連結，面向 RedHat、Fedora、Centos 和 Almalinux 的 COPR 倉庫連結，以及名為 nekobox 和 nekobox-git 的 AUR 軟體包。WinGet 和 Chocolatey 在 README 中只是標題，下面沒有命令或連結；來源沒有確定這些軟體包是否已經存在。

NyameBox、sing-box、nekobox_core sing-box --help、TUN、gvisor、happ:// 是本篇核對的專案記號。對實際採用有影響的細節包括命令名稱、設定鍵、模型或協定名稱，以及它們在文件中的上下文。 本節所談的 發行套件管道 應與 NyameBox、sing-box、nekobox_core sing-box --help、TUN、gvisor、happ:// 一起理解：若輸入、輸出或執行條件在 README 中有明確例子，便以例子為準；若只出現在說明、版本紀錄或路線圖，就不能推導成目前預設行為。對照時可記下 qr243vbi-nekobox-deep-analysis、發行套件管道 與本段列出的名稱，讓後續閱讀能回到相同位置。這種逐項對照也能看出文件涵蓋了什麼，以及哪些限制仍沒有答案。

FAQ 中記錄的設定問題

FAQ 涵蓋了幾個常見的設定問題。對於 TUN 模式失敗，README 建議開啟 tun 設定，將堆疊設為 gvisor，或更換 tun 位址（例如 168.19.0.1/24）。對於 Windows 7、8 和 8.1，建議先安裝 VxKex-NEXT，然後以 VxVex 模式啟動 NekoBox。「msvcp140.dll not found」錯誤被歸因於 Microsoft Visual C++ Redistributable 缺失或損壞，並附有微軟官方頁面連結。README 說明 Windows 上不需要以 UAC 模式執行；如果選擇了 TUN 模式且程式尚未以管理員權限執行，nekobox_core 會在 UAC 確認後重啟。在 Linux 上，不需要設定 SUID 位，但如果未設定，選擇 TUN 模式且程式未以 root 執行時，NekoBox 會請求一次管理員密碼來以特權重啟 nekobox_core。FAQ 還指出，低於 5.10.41 的版本在啟用系統代理時被強制退出，可能無法重置代理；對於低於 5.10.40 的版本，解決方法是重新開啟應用，啟用系統代理，再停用它。

NyameBox、sing-box、nekobox_core sing-box --help、TUN、gvisor、happ:// 是本篇核對的專案記號。只要把這些記號和該專案的原始段落放在一起閱讀，就能分辨已實作的描述、路線圖內容與尚未說明的邊界。 本節所談的 FAQ 中記錄的設定問題 應與 NyameBox、sing-box、nekobox_core sing-box --help、TUN、gvisor、happ:// 一起理解：若輸入、輸出或執行條件在 README 中有明確例子，便以例子為準；若只出現在說明、版本紀錄或路線圖，就不能推導成目前預設行為。對照時可記下 qr243vbi-nekobox-deep-analysis、FAQ 中記錄的設定問題 與本段列出的名稱，讓後續閱讀能回到相同位置。這種逐項對照也能看出文件涵蓋了什麼，以及哪些限制仍沒有答案。

待辦清單中的未完成工作

README 的 待辦 部分列出了維護者尚未完成的事項：命令列工具、nekobox_core 的 OpenRC/runit/systemd 整合、終端介面、遠端控制、支援 sing-box 和 Qt 支援的所有平台（macOS 和 iOS 除外）、新增更多上游 sing-box 不支援的協定（README 表示目前已新增：mieru、juicity、trusttunnel、vless encryption、xhttp transport、kcp transport、amnezia、snell，位於核心分支中）、用宣告式介面替換靜態介面來編輯代理，以及「找到世界上最好的資料庫儲存」。README 沒有給出這些事項的時間表或優先順序，也沒有說明哪些命令列工具仍然缺失，儘管開頭已經宣佈了 sing-box 命令列模式。

NyameBox、sing-box、nekobox_core sing-box --help、TUN、gvisor、happ:// 是本篇核對的專案記號。這一段的判讀要落在來源明列的介面，而不是把專案名稱當成能力保證。 本節所談的 待辦 清單中的未完成工作 應與 NyameBox、sing-box、nekobox_core sing-box --help、TUN、gvisor、happ:// 一起理解：若輸入、輸出或執行條件在 README 中有明確例子，便以例子為準；若只出現在說明、版本紀錄或路線圖，就不能推導成目前預設行為。對照時可記下 qr243vbi-nekobox-deep-analysis、待辦 清單中的未完成工作 與本段列出的名稱，讓後續閱讀能回到相同位置。這種逐項對照也能看出文件涵蓋了什麼，以及哪些限制仍沒有答案。

授權條款與聯絡方式

README 聲明使用本軟體須遵守 GPL-3 授權條款，儲存庫元資料列出的 SPDX 標識為 GPL-3.0。授權條款摘錄說明 GPL 是一個 copyleft 授權條款，保證共享和修改軟體的自由，要求接收者能夠收到或取得原始碼，要求修改版本必須標記為已更改，並聲明該自由軟體不提供任何擔保。摘錄沒有提到安全保證、支援承諾，也沒有超出標準免責聲明的具體擔保條款。如有問題，README 引導使用者提交 GitHub issue，或透過 Matrix 聯絡 @qr243vbi:matrix.org。

NyameBox、sing-box、nekobox_core sing-box --help、TUN、gvisor、happ:// 是本篇核對的專案記號。從 README 的安排來看，這個元件處理的是明確的輸入與輸出關係，使用者可以沿著列出的入口逐步核對。 本節所談的 授權條款與聯絡方式 應與 NyameBox、sing-box、nekobox_core sing-box --help、TUN、gvisor、happ:// 一起理解：若輸入、輸出或執行條件在 README 中有明確例子，便以例子為準；若只出現在說明、版本紀錄或路線圖，就不能推導成目前預設行為。對照時可記下 qr243vbi-nekobox-deep-analysis、授權條款與聯絡方式 與本段列出的名稱，讓後續閱讀能回到相同位置。這種逐項對照也能看出文件涵蓋了什麼，以及哪些限制仍沒有答案。

編輯結論

README 將 NyameBox 定位為基於 sing-box 的 Qt 代理用戶端，列出了大量協定、多種訂閱匯入格式和多個發行管道，並保留了一份沒有時間表的 待辦 清單。

官方來源

1. Official documentation
2. Official README
3. Project repository
4. Release notes