Railway 在 2026 年 11 月 5 日更新工作區憑證與高可用資料庫維運功能。工作區管理員現在能在 Workspace Settings 的 Tokens 頁面查看所有 workspace token、建立者與建立時間,並撤銷不再需要的 token;建立與撤銷動作也會進入 audit log。另一方面,Postgres、MySQL、Redis 與 MongoDB 的 HA cluster 可在介面協調輪替密碼,其中 MongoDB HA 仍屬 Priority Boarding。
這兩項功能解決的是不同風險:Token 管理回答「哪些自動化能控制整個工作區」,密碼輪替回答「資料庫帳密如何在多個節點保持一致」。它們不是一鍵完成所有秘密輪替。Railway 會處理平台內的 cluster member、proxy 與引用 Railway variable 的服務,但硬編碼密碼、其他 project 的服務及 Railway 外部應用仍要由團隊更新。
Workspace token 應視為工作區管理員
Railway 的 access group 文件明確指出,workspace token 代表工作區本身,而不是某位使用者,因此不會套用群組成員資格;它可以觸及工作區內每個 project,包括沒有加入任何 access group 的 project。這種 token 應視為等同 workspace admin,而不是一般 CI 金鑰。
先從 Tokens 頁面建立清冊,記錄建立者、用途、secret 儲存位置、最近使用證據、負責人與預定撤銷日。無法說明用途、建立者已離職或重複發行的 token,應先找出依賴,再以替代 token 漸進切換。不要因為新的集中頁面能看見 token,就直接大量撤銷;背景排程、IaC、MCP 或舊部署流程可能只在低頻事件執行。
若整合只需要單一 project 與 environment,優先改用 project token。workspace token 只留給真正跨 project 的治理流程,並限制在受控 secret manager、固定 runner 與少數維運者。撤銷前先讓新舊 token 短暫並存,測試查詢、部署與拒絕路徑,切換完成後再撤銷舊值。
Audit log 能留下 actor、時間與事件內容,但保存期依方案不同。官方文件列出 Free、Trial 與 Hobby 為 48 小時,Pro 為 30 天,Enterprise 為 18 個月。需要長期追蹤的團隊不能只依賴介面查詢,應依方案與合規需求評估定期匯出;也要確認 token 建立、撤銷和異常部署確實出現在紀錄中。
HA 密碼輪替會改動哪些元件
在 HA database 的 Config 頁面選擇 Regenerate 後,Railway 會先確認 primary 與 replica 都接受目前密碼並能接收新密碼,接著逐一變更 live primary、replica,以及 Postgres 的 etcd 節點。之後才提交密碼 variable、重建 proxy 或 etcd 相關節點,並逐一重新部署引用該 variable 的執行中服務。
如果在密碼 variable 提交前失敗,Railway 會嘗試把所有 member 還原到舊密碼;提交後若有元件未完成,介面會指出仍需 redeploy 的項目。Cluster member 一般不需為輪替重新啟動,但較舊 image build 會先被 redeploy;若該 member 是 primary,failover 可能造成短暫寫入中斷。不能把「協調輪替」解讀成任何架構都保證零停機。
更重要的是引用方式。若服務的變數是另一個 Railway variable 的 reference,平台能在輪替時辨識並更新;若密碼曾被複製成純文字、寫在 container image、另一個 project、外部分析工具或本機維運腳本,平台不會自動找到。這些 client 在舊密碼被拒絕後會出現 authentication error。
也不要用手動修改 variable 或資料庫內的 ALTER USER 取代 Regenerate。官方文件說明,前者只改環境變數,執行中的資料庫不會因此更新內部帳密;後者只改資料庫,Railway variable 仍保留舊值。兩邊不同步時,應先恢復成一致狀態,再使用平台支援的輪替流程。
上線前的盤點與演練
第一步列出所有資料庫 client:web service、worker、cron、BI、外部 ETL、維運工具、連線池、唯讀副本與災難復原流程。對每個 client 記錄連線來源、密碼取得方式、是否能重新載入 secret、連線池存活時間與負責人。低頻月結工作也要納入,不能只觀察最近幾分鐘的連線。
第二步在非正式 HA cluster 演練。輪替前建立正常讀寫基線,過程中持續送出可辨識的讀寫請求,記錄錯誤率、重新連線時間與 failover 期間的寫入中斷。輪替後確認舊密碼失效、新密碼可用、replica 狀態正常,並檢查所有引用服務是否完成 redeploy。
第三步準備外部 client 的雙階段更新。先確保應用能重新載入 secret 或快速重新部署,再安排輪替;取得新值後立即更新外部 secret store 與連線池。若工具只能在啟動時讀取密碼,就把重啟順序與容許中斷寫進 runbook。不要把新密碼貼進工單、聊天紀錄或 repository。
第四步觀察授權與資料庫兩類訊號。Token 改動要看 audit log、401/403 與部署 actor;資料庫輪替要看 authentication error、連線池、replication、failover 與業務寫入。兩者同時變更會增加診斷難度,正式環境最好分成不同維護窗口。
怎麼選擇輪替策略
小型單 project 系統若沒有跨專案自動化,可把 workspace token 收斂成 project token,再輪替資料庫;這能先縮小控制面風險。多 project 平台則應保留極少數 workspace token,明確標記 owner 與期限,並用 audit log 驗證每次變更。
HA database 內的服務若全部透過 Railway variable reference 連線,平台協調流程能減少人工步驟;只要存在外部 BI、另一個 project 或硬編碼值,就要視為跨系統憑證遷移。需要嚴格零寫入中斷的工作負載,應先驗證舊 image 是否會觸發 failover,並在業務層準備暫停寫入、重試或補償機制。
完成條件不是 Dashboard 顯示 Regenerate 成功,而是 workspace token 都有用途與責任人、過寬 token 已撤銷、資料庫新密碼在所有合法 client 生效、舊密碼確實被拒絕,且短暫中斷與失敗處理都經過演練。