部署開源專案,真正麻煩的往往不是「把檔案上傳到主機」,而是環境版本、資料庫權限、DNS 設定和後續維護是否能一次配置正確。以 AZhai Sub 這類二級域名管理器為例,專案需要 PHP 8 與 MySQL 8,還會連接 Cloudflare、阿里雲 DNS 等服務商 API,因此建議先準備一台支援 HTTPS 的 VPS 或網站主機,再開始安裝,會比單純解壓縮檔案穩定得多。
AZhai Sub 的基本部署流程
先將專案檔案上傳至網站根目錄,例如 /www/wwwroot/azhai-sub,解壓後確認 config.php 等核心檔案沒有被主機權限阻擋。接著在 MySQL 8 建立獨立資料庫與資料庫使用者,再匯入專案附帶的 database.sql。不建議直接使用 root 帳號連線,因為網站一旦出現漏洞,資料庫權限過大會放大風險。
修改 config.php 時,至少要填寫資料庫主機、資料庫名稱、使用者名稱與密碼。如果要啟用阿宅 OAuth,也要把 OAuth Client ID 和密鑰一併寫入設定檔。完成後透過 https://你的域名/admin 開啟後台,預設帳號是 azhai,密碼是 azhai123。這組密碼公開且容易猜,首次登入後務必立即更換,最好再限制後台登入來源或啟用額外驗證。
DNS 與 SSL 設定不能忽略
AZhai Sub 的核心功能是管理二級域名,因此主域名的 DNS 配置必須先準備好。通常需要將泛域名,例如 *.xxx.com,指向網站伺服器或反向代理;否則即使系統成功建立 you.xxx.com,底下的子域名仍可能無法正常訪問。
在 DNS 服務商後台建立 API Token 時,建議只授予指定主域名的 DNS 編輯權限,不要直接使用帳戶主密鑰。Cloudflare、阿里雲 DNS、華為雲 DNS 和騰訊雲 DNS 的權限模型略有差異,測試時可先建立一筆 A 或 CNAME 記錄,確認自動同步確實生效,再開放給一般使用者申請。
SSL 憑證功能則要配合正確的解析與驗證流程。TXT 根域名驗證需要管理員審核,並手動新增 TXT 記錄,這一步不能只期待系統自動完成。若憑證申請失敗,先檢查 DNS 是否已傳播、伺服器 80/443 埠是否開放,以及反向代理是否攔截驗證請求。
上線後的維護建議
正式使用前,至少測試註冊、域名審核、DNS 記錄新增、SSL 申請和域名暫停等流程。MySQL 建議每日備份,並保留操作日誌;系統更新功能雖然方便,但升級前仍應備份資料庫與設定檔。開源專案最可貴的是能自由修改,但也代表管理者要對安全更新、API 密鑰和伺服器權限負責。部署成功只是起點,能穩定運行半年以上,才算真正把專案用起來。

評論(4)
泛域名解析這一步真的很容易漏掉,部署前先確認會省很多麻煩
資料庫用獨立帳號而不是 root,這個安全細節很實用
想請問之後如果更換 DNS 服務商,原本的設定需要重新配置嗎?
預設密碼這種資訊公開後,登入第一件事確實要先改掉