步驟 1
準備一台主機
- 64 位元 Linux 主機
實體機或虛擬機都可以,例如 Ubuntu Server。 - Docker 與 Docker Compose
主控台本身就是一個容器。 - Git
用來下載與更新原始碼。
免費、開源。準備一台 Linux 主機,照下面幾步就能跑起來;之後裝置、硬碟、成員都在介面裡自己新增。
下載原始碼,複製設定範本,再產生一組登入金鑰貼到 .env 的 AXIS_JWT_SECRET,並設定管理員密碼 AXIS_ADMIN_PASS。
git clone https://github.com/deven951130/Absolute-Axis.git
cd Absolute-Axis
cp .env.example .env
# 產生登入金鑰,貼到 .env 的 AXIS_JWT_SECRET
openssl rand -hex 32
nano .env
第一次會建置映像檔,需要幾分鐘。
docker compose up -d --build axis-server
瀏覽器打開 http://主機 IP:8000,用管理員帳號 sparkle 與你設定的 AXIS_ADMIN_PASS 登入,再到「系統設定 › 個人身分與安全密碼」改成你自己的名稱與密碼。
.env 設定只有前兩項必填,其他用到再填。
| 項目 | 說明 |
|---|---|
AXIS_JWT_SECRET必填 | 登入金鑰,32 字元以上的隨機字串;沒填主控台不會啟動。 |
AXIS_ADMIN_PASS必填 | 第一次啟動時建立管理員 sparkle 用的密碼。 |
PVE_HOST、PVE_TOKEN_*選用 | 連上你的 Proxmox,在虛擬化中心管理虛擬機。.env.example 裡有建立最小權限 token 的指令。 |
DEVICEHUB_*選用 | 連上 DeviceHub 裝置服務,啟用智慧宅控的裝置與遠端開關機。 |
CLOUDFLARE_TUNNEL_TOKEN選用 | 想從外面連線時使用;填好後另外執行 docker compose up -d cloudflared。 |
智慧宅控 › 新增裝置
掛載後會自動出現在 NAS 管理 › 儲存池。要讓私有雲放到新硬碟,把 docker-compose.yml 裡的 ./nas 改成新硬碟的掛載路徑。
帳號管理 › 新增成員
系統設定 › 模組化功能
主控台預設只在區網使用。要從外面連回家,建議用 Tailscale 或 Cloudflare Tunnel 這類加密通道,不要直接在路由器開放連接埠。
目前沒有另外的 Windows/macOS 用戶端:主控台就是網頁,手機和電腦直接用瀏覽器開。