自架
設定
執行個體每次啟動都會讀取根目錄的 .env。修改 .env 後請執行
docker compose down && docker compose up -d --build
重建服務(變更 COMMA_API_URL 時必須重新建置網頁端)。
擁有者帳號
首次啟動前請設定 COMMA_OWNER_EMAIL,該信箱即為擁有者並可存取
http://localhost:8082 的管理主控台。COMMA_ALLOW_SIGNUP
預設為 false,可於公開託管時關閉自由註冊。
公開 HTTPS 部署請將 COMMA_PUBLIC_URL、COMMA_ADMIN_URL、COMMA_API_URL
與 COMMA_SALIX_URL 設為同一可註冊網域下的 HTTPS 來源(例如
https://app.example.com、https://admin.example.com、https://api.example.com、https://salix.example.com),因為工作階段
Cookie 使用 SameSite=Lax。同時設定真實
SMTP:COMMA_SMTP_HOST、COMMA_SMTP_PORT、COMMA_SMTP_FROM、COMMA_SMTP_USERNAME、COMMA_SMTP_PASSWORD,以及
COMMA_SMTP_TLS=always 或 COMMA_SMTP_SSL=true。
模型供應商
| 設定 | 用途 |
|---|---|
COMMA_LLM_BASE_URL |
供應商端點(例如 https://api.openai.com/v1) |
COMMA_LLM_PROTOCOL |
API 協定,例如 chat_completions |
COMMA_LLM_MODEL |
確切的模型 ID |
COMMA_LLM_API_KEY |
供應商 API 金鑰 |
COMMA_LLM_CONTEXT_TOKENS |
模型上下文預算(預設 128000) |
COMMA_LLM_MAX_TOKENS |
輸出 Token 上限(預設 8192) |
未設定時,每位使用者登入後仍可在設定中新增個人模型;呼叫會直接使用該使用者的供應商帳號並由供應商計費。
網頁搜尋
設定 COMMA_EXA_API_KEY 可透過 Exa 啟用網頁搜尋與頁面讀取。
請妥善保管 .env:檔案中包含你的模型與 SMTP 金鑰。