vpn-deploy-skill 是做什麼的？
用於合法自架 Shadowrocket VPN 部署的 Codex 技能，支援 sing-box、TLS/WebSocket、私人訂閱與路由規則。
概述
此技能自動化部署自架式 Shadowrocket VPN 服務，使用 sing-box 作為代理核心，並結合 TLS/WebSocket 加密傳輸。透過私人訂閱機制，使用者可以安全地在用戶端（如 Shadowrocket）導入配置，並靈活控制路由規則。
功能特性
- sing-box 整合：自動生成及部署 sing-box 伺服器端配置文件。
- TLS/WebSocket 支援：配置 Let's Encrypt 或自簽 TLS 憑證，啟用 WebSocket 傳輸。
- 私人訂閱管理：產生唯一的私人訂閱鏈接，方便用戶端下載配置。
- 彈性路由規則：自定義繞過規則（例如中國大陸直連、自定義例外清單等）。
- 跨平台支援：伺服器端支援 Linux（Ubuntu/Debian/CentOS），用戶端支援 iOS、macOS 及 Windows。
使用方式
前置需求
- 一台可公開訪問的 Linux 伺服器（建議 Ubuntu 22.04+）。
- 一個網域名稱（用於 TLS，或使用 IP 自簽憑證）。
- 已安裝 Codex 或其他相容的 AI 代理。
安裝
- 將此技能加入專案目錄：
cd your-project
mkdir -p .codex/skills
# 將技能檔案複製至此目錄
cp sukiriho-vpn-deploy-skill.md .codex/skills/
- 設定環境變數：
export DOMAIN="yourdomain.com"
export EMAIL="[email protected]" # 若使用 Let's Encrypt
export VPN_PORT=443 # WebSocket 埠號（建議 443）
部署
透過 Codex 執行下列指令：
/codex enable sukiriho/vpn-deploy-skill
/codex run deploy-vpn
技能將會：
- 在伺服器上更新套件並安裝 sing-box。
- 自動生成 sing-box 配置檔案（
/etc/sing-box/config.json）。 - 配置 TLS 憑證（若提供網域則自動取得 Let's Encrypt 憑證）。
- 啟動 sing-box 服務並設定開機自啟。
- 輸出私人訂閱鏈接（格式：
shadowrocket://...）。
用戶端配置
- 在 iOS/macOS 上安裝 Shadowrocket 應用程式。
- 點擊技能提供的訂閱鏈接，自動導入伺服器配置。
- 按需求調整路由規則（例如「代理清單」與「直連清單」）。
路由規則範例
技能預設路由規則包含：
- 代理流量：Google、YouTube、Twitter、GitHub 等常用服務。
- 直連流量：中國大陸網站（如百度、淘寶）及本地網路。
- 自訂規則：可在設定檔案的
route.rules部分新增自訂條目。
安全注意事項
- 確保管理員密碼及 TLS 私鑰安全儲存。
- 定期檢查伺服器安全更新。
- 僅將此技能用於合法用途，遵守當地法律。
支援平台
| 平台 | 支援狀態 |
|---|---|
| Linux (伺服器端) | ✅ 已驗證 |
| iOS (Shadowrocket) | ✅ 已驗證 |
| macOS (Shadowrocket) | ✅ 已驗證 |
| Windows | ⚠️ 需手動設定 |
故障排除
若連線失敗，請檢查：
- 伺服器防火牆是否開放指定埠號（預設 443）。
- TLS 憑證是否過期或無效。
- sing-box 服務是否正常執行：
sudo systemctl status sing-box - 用戶端時間是否與伺服器同步。
貢獻
歡迎提交 Issue 或 Pull Request 改善此技能。
授權
MIT License