下載與教學

在要遠端控制、加入私人網路或發布服務的電腦安裝 tenon-agent。檔案直接由這台伺服器提供。

你想完成哪件事？

四份教學皆附本地示範截圖；以下保留下載檔案與指令速查。

下載安裝檔

Windows 建議使用安裝程式；可攜套件解壓縮後也能使用。Linux／macOS 下載對應架構的執行檔。

平台下載
Windows x64 可攜套件（含虛擬網卡驅動）tenon-agent-windows-amd64.zip
SHA-256 校驗碼4e91c7db19d569d7b60f2921d21ba987634863f9d22df47e4331fa4846a7df7d
Windows x64 安裝程式tenon-agent-setup-windows-amd64.exe
SHA-256 校驗碼a96e3a3db8e3fd08d4ea29fdd8f11570798bdcc80f4b1161f2a5655345f447a8
Linux x86_64tenon-agent-linux-amd64
SHA-256 校驗碼e7d4d6e471e2921eaac75eeee378b99c7d4b98867860e26dbff09a2e48842f43
Linux ARM64（樹莓派 4/5、Oracle A1）尚未上傳，請洽管理者
Windows x64tenon-agent-windows-amd64.exe
SHA-256 校驗碼3c4775a32bee73b64650699bf49da524ab6f44723651d020427dac1a74b425c7
macOS（Apple 晶片）尚未上傳，請洽管理者
macOS（Intel）尚未上傳，請洽管理者

Windows：PowerShell 執行 Get-FileHash .\檔名 -Algorithm SHA256 比對校驗碼。安裝程式若未經程式碼簽章，Windows 可能顯示發行者未知。

被控端指令速查

Windows：開啟「系統管理員 PowerShell」，切換到安裝目錄，再執行：

.\tenon-agent.exe rd service install --server rd.226network.com:21116 --key l52EAnKybVpcnbF1ipUo+jTKwBhYwlpDYfPa1MCXJbo=
.\tenon-agent.exe rd id
.\tenon-agent.exe rd password 你的固定密碼
.\tenon-agent.exe rd service status

服務開機自動啟動，登出後仍能連線。管理網頁的「遠端連線」輸入剛剛顯示的 ID 和固定密碼即可控制；也可以使用 Tenon Desktop。

要允許服務送 Ctrl+Alt+Del，可由系統管理者依公司政策開啟「停用或啟用軟體安全注意序列」→「服務」，對應登錄值 HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\SoftwareSASGeneration=1（DWORD）。程式不會自行變更此政策。

登入／UAC 安全桌面依 Windows 安全政策與顯示驅動而異；尚待實機驗收。服務目前控制本機主控台工作階段，不支援多個 RDP 工作階段同時控制。

移除服務：.\tenon-agent.exe rd service uninstall，身分檔會保留；日誌位於 %ProgramData%\tenon\rd-service.log。

Linux／macOS：在圖形工作階段執行 
# 以 Linux x64 為例；macOS Apple 晶片請把來源檔名改成 tenon-agent-darwin-arm64
mv ./tenon-agent-linux-amd64 ./tenon-agent
chmod +x ./tenon-agent
./tenon-agent rd up --server rd.226network.com:21116 --key l52EAnKybVpcnbF1ipUo+jTKwBhYwlpDYfPa1MCXJbo=

Linux X11 需要 Xorg、XCB、DBus、PipeWire 開發／執行環境；Wayland 需桌面提供螢幕擷取 portal 並由使用者核准。macOS 到「系統設定 → 隱私權與安全性 → 螢幕錄製」允許終端機／tenon-agent，再重新啟動程式。這兩個平台目前提供畫面擷取，鍵鼠模擬尚未實作。

tenon-agent VPN 指令速查

到管理網頁「金鑰」產生 VPN 註冊金鑰，再以管理員／root 執行：

.\tenon-agent.exe vpn up --server https://vpn.226network.com --auth-key tpk_你的註冊金鑰 --tun

Windows 的可攜套件與安裝程式已附官方簽章的 wintun.dll，必須留在執行檔旁邊。Linux／macOS 將指令的執行檔改成 sudo ./tenon-agent。虛擬網卡啟動後，其他程式可直接連 VPN 位址；Ctrl-C 結束會清掉本次新增的路由。

要接收已核准的子網路路由加 --accept-routes；目前不接管預設路由，也不自動改系統 DNS。可以用 VPN IP 連線。沒有管理員權限則使用 --socks5 127.0.0.1:1055，與 --tun 擇一。

網頁傳檔與聲音

  1. 進入「遠端連線」並連上裝置。
  2. 點「傳檔」，選擇遠端資料夾；點檔名下載，或選擇本機檔案上傳。單檔上限 256 MiB，同名上傳會先提醒覆蓋，傳送中可取消。
  3. 點「聲音：關」切換為開啟；第一次點擊後瀏覽器才開始播放。tenon-agent Windows 被控端擷取系統播放音效，不使用麥克風。其他平台需由被控端提供 Opus 音訊。

網頁傳檔與聲音和畫面使用同一條端對端加密連線；管理伺服器只轉送資料。中斷後請重新傳檔。

發布網站／內部服務

開啟 Tunnel 圖文教學，依序建立 Token、安裝連接器並發布服務。這與遠端桌面的 rd service 是獨立服務，可同時使用。