使用者

成員
我的帳號
安裝說明

把 Absolute Axis
裝到你自己的主機

免費、開源。準備一台 Linux 主機,照下面幾步就能跑起來;之後裝置、硬碟、成員都在介面裡自己新增。

步驟 1

準備一台主機

  • 64 位元 Linux 主機
    實體機或虛擬機都可以,例如 Ubuntu Server。
  • Docker 與 Docker Compose
    主控台本身就是一個容器。
  • Git
    用來下載與更新原始碼。
步驟 2

下載並填好設定

下載原始碼,複製設定範本,再產生一組登入金鑰貼到 .env 的 AXIS_JWT_SECRET,並設定管理員密碼 AXIS_ADMIN_PASS。

bash
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
步驟 3

啟動

第一次會建置映像檔,需要幾分鐘。

bash
docker compose up -d --build axis-server
步驟 4

登入並改成你自己的帳號

瀏覽器打開 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 這類加密通道,不要直接在路由器開放連接埠。

下載 ZIP不用 Git 也可以,下載後解壓縮
GitHub 原始碼deven951130/Absolute-Axis

目前沒有另外的 Windows/macOS 用戶端:主控台就是網頁,手機和電腦直接用瀏覽器開。