系統設定

五個分頁。一次全部儲存，並立即套用到排程、建置與通知——沒有重啟這個步驟。

一般

欄位	說明
站台名稱	顯示在頁首與通知標題。
對外網址	用來組出通知裡的連結。沒設的話通知連結點了沒用。
時區	Cron 運算式依這個時區求值，不是 UTC，也不是瀏覽器的時區。
介面語系	繁體中文、English 或日本語。見語言與翻譯。
資料庫	預設 SQLite，位置以 API content root 為基準。可用 ConnectionStrings:Walis 覆寫，並以 Database__Provider 指定種類（sqlite、postgresql、mysql、sqlserver）。SQLite 以外都能給多個節點共用——見高可用。

建置

欄位	說明
同時建置上限	本機執行器的插槽數。
預設逾時	套用在沒有自訂逾時的任務上。
紀錄保留天數	建置紀錄與產出檔案的保留天數（稽核紀錄另有獨立的保留天數）。
預設工作目錄	沒有自訂目錄的任務的根目錄；每個任務用它底下以任務編號命名的子目錄。
預設 Shell	每個步驟執行時所用的 shell。

隔離建置

預設開啟。在有沙箱的平台（macOS）上，每個步驟以 sandbox-exec 包住，不能讀寫 Walis 資料目錄，也不能碰額外禁止存取的路徑列出的位置。Windows 與 Linux 沒有沙箱可套用，這個開關在那裡不會改變任何事：內建執行器的建置以服務帳號的權限執行，頁面會顯示警告說明這一點。

寫規則之前，路徑會逐段解析符號連結。這件事比聽起來重要：macOS 上 /tmp 與 /var/folders 的連結在路徑中間，針對未解析路徑寫的規則會完全不生效。

沒有隔離邊界時拒絕執行

預設關閉，為的是每個平台第一次建置就能執行。開啟之後，沒有任何隔離的地方就不再執行建置：

• Windows 或 Linux 上的內建執行器會拒絕執行建置；
• 遠端執行器的名稱要列在已置於外部隔離的執行器，而且以 --external-isolation true 啟動，才領得到工作。

已置於外部隔離的執行器

一行一個執行器名稱，只有上面的開關開啟時才會用到。執行器所在的實體機、VM 或容器只用來跑 Walis 的建置時才列進來；Walis 無法替你檢查那道邊界是否存在。

允許的工作目錄

一行一個，留空表示不限制。清單非空時，工作目錄不在其中的任務會直接失敗，而不是跑到意料之外的地方。

產出檔案與工作目錄

• 保留建置產出檔案——成功後依任務的產出路徑複製出來，上限 200 檔／64 MB，可在日誌視窗下載。
• 每次建置前清空工作目錄——只刪目錄內容。磁碟根目錄、家目錄與層級過淺的路徑一律拒絕。清空發生在還原快取之前。
• 每次建置後清空工作目錄——在產出檔案與快取保存之後清空目錄內容（任務可個別覆寫），避免簽出的原始碼與腳本寫下的憑證留到下一次建置。

備份

見備份與還原。

安全

TIP

Walis 現已提供獨立的安全中心（/security），將態勢健檢、高權限盤點、暴力防護解鎖與安全稽核整合為全功能儀表板。此處的安全分頁設定與安全中心政策分頁互相同步。

欄位	說明
啟用管理端登入	預設開啟。關閉時，未登入的訪客只能檢視，仍然不能修改任何設定或觸發建置。最後一位管理員刪不掉。
要求所有帳號啟用一次性密碼	尚未設定的帳號登入後只能前往 OTP 設定畫面完成註冊，之後無法自行停用。
記錄操作稽核紀錄	任務、建置、執行器、變數、設定、通知、翻譯，以及登入失敗與鎖定事件。
稽核保留天數	預設 365 天（最少 30 天），與建置紀錄保留天數分開計算。
在建置輸出中遮蔽機密值	預設開啟。關掉會把機密原樣印進會被保留的日誌。
允許的 CORS 來源	一行一個，儲存後立即生效。未設定時退回 127.0.0.1:11124 與 localhost:11124。
MCP 允許的來源位址	一行一個 IPv4／IPv6 位址或 CIDR 範圍。非空時，不在清單上的位址在驗證金鑰前即拒絕存取 /mcp。
Webhook 密鑰	設定後，推送請求必須帶 X-Hub-Signature-256、X-Gitlab-Token 或 X-Walis-Token。
推送 webhook 網址	要貼到 GitHub 或 GitLab 的位址，旁邊有複製鈕。
機密加密	顯示主金鑰來源（Security:EncryptionKey 或資料目錄的 secret.key），並可清除換金鑰或跨機還原後無法解密的值。

稽核

開啟記錄後的操作軌跡，含操作者、來源位址（remoteAddress）與結果，支援篩選與 CSV 匯出。依獨立的稽核保留天數清理，且在還原備份時會與既有紀錄合併保留、不會被清空。

設定可攜

匯出把所有任務與自訂動作寫成 JSON，刻意不含識別碼、統計與時間戳——那些描述的是這台機器，不是設定本身。

匯入依名稱比對。overwrite 為 false 時同名略過；為 true 時就地更新，識別碼與建置紀錄保留。

動作流程在匯出檔裡是物件而不是跳脫字串，所以 diff 讀得懂、可以 code review。