伺服器係你自己嘅
單機控制平面，不是多租戶 reseller 面板。資料與設定留在你指定的資料目錄。
免費開源MIT · 公開使用
面板 ≡ CLI ≡ API同一核心 · 可腳本化
:9287HTTPS 面板（首次自簽）
誠實運維root + YSK_EXECUTE=1
一台你擁有的伺服器
不是多租戶 SaaS 鎖死 — 面板、命令列與 API 共用同一核心，改主機前先 dry-run。
- 操作員瀏覽器／終端／AI agent
- 面板 · CLI · API同一套指令與權限
- 核心網站 · 電郵 · 檔案 · 防護
- 主機執行器預設 dry-run · 套用需 EXECUTE
- Linux 主機Nginx／DB／Mail／檔案
操作員（瀏覽器 / 終端 / AI agent）
│ 面板 HTTPS :9287 · CLI ysk-server · API ysk_*
▼
控制平面（同一核心）
· 專案 / 檔案 / 電郵 / 資料庫 / DNS·SSL / 防護
· 寫入 dataDir（written）≠ 已套用到主機（applied）
· 2FA · RBAC · 稽核
│
▼
主機執行器（預設 dry-run）
· 真正改機：root + YSK_EXECUTE=1
│
▼
你的 VPS／實體機（Ubuntu 22.04 / 24.04）
面板 ≡ CLI ≡ API
同一核心、同一能力。人手用面板；腳本與 AI agent 用 --json。
誠實運維
不會假裝成功。危險主機操作預設 dry-run，直至 root + YSK_EXECUTE=1。
完整主機棧
專案、Nginx／Apache、SSL、資料庫、電郵、FTP、BT 分享與防護中心 — 一機管完。
| 範疇 | 重點 |
|---|---|
| 網站 | 專案、部署、隔離、多執行環境（Node／PHP／靜態等） |
| 檔案 | 沙箱檔案管理員、公開分享、WebDAV、FTP、BT Tracker／WebTorrent |
| 電郵 | 網域、郵箱、DNS 套件、投遞檢查（不保證全球入匣） |
| 資料 | MySQL／MariaDB／PostgreSQL／Redis |
| 邊緣 | DNS、SSL、Nginx、Apache、CDN agents |
| 安全 | 防護中心、SSH／2FA、VPN、VNC、API 金鑰 |
| 運維 | 指標、日誌、終端、Cron、備份、更新 |
| 授權 | MIT · 免費公開使用 · CLI ysk-server |
主機棧
網站到防護同一台機 — 每項都有對應 CLI，改主機前可先看計劃。
網站與專案
- 建立、部署、停止、健康檢查、Git 部署、作業系統隔離與範本
- 多執行環境：Node、PHP、靜態站等
- 未開
YSK_EXECUTE=1時，部署只出計劃，不會假裝已上線 - 已部署 ≠ 已公開 — 仍要 Nginx／SSL 套用
檔案、分享與 BT
- 沙箱檔案管理員（公開根或專案根），不是無限制遠端 SSH 瀏覽
- 公開分享：直接 HTTP、BitTorrent／WebTorrent，或兩者一齊
- WebDAV 權杖；FTPS 帳戶（套用到主機需 EXECUTE）
- 內建 BT Tracker；瀏覽器 WebTorrent 走同源代理，唔靠公開 CDN
電郵
- 郵件網域、郵箱、別名、佇列、可選 SMTP 轉發
- DNS 套件與投遞檢查 — 分數如實，不保證全球入匣
- PTR、25 埠與黑名單要在主機／ISP 另行處理
- 安裝 唔等於 電郵聲譽「一鍵保證入匣」
資料庫
- MySQL／MariaDB、PostgreSQL、Redis
- 面板與 CLI 同一套建立／列表／套用流程
- 套用到系統套件同樣受 EXECUTE 閘
DNS、SSL、Nginx、Apache
- DNS 與 Let's Encrypt／面板 TLS；首次面板用自簽憑證
- Nginx 站點控制台；Apache 獨立頁面
- CDN agents 可把邊緣節點納入同一控制面
- 有域名後請用 Let's Encrypt 換走自簽憑證
防護、VPN、VNC
- 防護中心：防火牆、fail2ban、封鎖／解封、預設檔
- SSH 身分、面板與 SSH 2FA
- VPN 伺服器／用戶端；VNC 帳戶與分享
- 缺工具時 fail-closed，唔會假成功
指標、備份與更新
- 指標、日誌中心、終端、Cron、備份、更新
- 就緒檢查：
ysk-server readiness --json - 主機瀏覽屬面板 UI；危險操作仍走 EXECUTE
- 允許清單內的 AI 工具／
ask，唔會繞過 dry-run
安全與誠實
寫入設定檔唔等於已套用到主機。預設保守，明確授權先改機。
登入、2FA 與 API
- 安裝結尾打印帳密，亦寫入
$dataDir/BOOTSTRAP-CREDENTIALS.txt - 首次登入後請改密碼並開啟 2FA
- API 金鑰前綴
ysk_*；變更路由預設 fail-closed RBAC - 高風險工具要允許清單／核准，唔係開放式 root shell
written ≠ applied
- 受管設定通常先落入
dataDir（written） - 複製／重載到系統服務要
YSK_EXECUTE=1（applied） - 多數主機突變另需 root（useradd、apt、系統 Nginx 等）
- CLI 預設 dry-run，直至
--execute／--apply
三條誠實說明
- 安裝 ≠ 電郵／DNS 聲譽保證。入匣取決於 PTR、25 埠、黑名單與營運。
- 危險操作預設 dry-run。直至
YSK_EXECUTE=1，唔會假裝已改機。 - 自簽面板憑證只為首次登入。有域名後請用 Let's Encrypt 取代。
YSK Server 不是多租戶 reseller SaaS，亦不保證全球電郵入匣。
命令列與 AI agent
面板能做的，CLI 用同一核心做；agent 請優先 --json。
CLI ysk-server
ysk-server readiness --json— 就緒探針ysk-server help --locale zh-HK— 說明（預設繁中香港）export YSK_EXECUTE=1— 真正改主機先要- 專案、電郵、檔案、防護、備份等子命令與面板對齊
- 完整參考：GitHub
docs/cli/reference-ZH.md
給 AI agent
ysk-server tools --json·ysk-server ask "list projects" --json- 工具走允許清單與防護模式，唔會繞過 EXECUTE
- 機器目錄：
docs/agent/commands.json - 專案 skill：
.grok/skills/ysk-server/SKILL.md
面板截圖與安裝
建議 Ubuntu 22.04／24.04，用 root 安裝。其他 Linux 盡力支援。
01
儀表板
服務健康、就緒檢查、安全與套用狀態。
02
系統工具
身份、面板 HTTPS、網絡與儲存。
裝完即可用
- root 執行 install.sh（或 npm／git）
- systemd 啟動
ysk-server - 開啟
https://<IP>:9287（接受自簽警告） - 用安裝帳密登入 → 改密碼 · 開 2FA
curl -fsSL https://raw.githubusercontent.com/yanshekki/ysk-server/main/install.sh \
| bash -s -- --non-interactive
# 或 npm
npm install -g ysk-server
ysk-server setup
ysk-server serve
# 卸載（保留資料）
sudo ./uninstall.sh --all --keep-data --yes需要代管、加固或客製？聯絡 YSK Limited — 此頁不標價。
常見問題
係。MIT 開源，免費公開使用。需要代管、加固或客製可聯絡 YSK Limited，此頁不標價。
唔係。佢係單機 Linux 控制平面：一台你擁有的 VPS／實體機，面板、CLI 與 API 共用同一核心。
建議 Ubuntu 22.04／24.04。其他 Linux 盡力支援。預設面板埠 9287。
唔會。安裝唔等於電郵／DNS 聲譽保證。入匣取決於 PTR、25 埠、黑名單與營運。