---
title: "設定 · Comma 文件"
description: "執行個體從 .env 檔案讀取的設定。"
url: https://comma.surf/zh-tw/docs/self-host/configuration
language: zh-TW
---

自架

# 設定

執行個體每次啟動都會讀取根目錄的 `.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 金鑰。
