fix: restore required setup fields

- require CPA_URL and API_KEY again in setup checks while keeping proxy fields optional\n- default CPA_URL and auto-generate API_KEY when saving setup config\n- remove the host.docker.internal host-gateway mapping from default compose/docs

docker-compose.yml

@@ -1,8 +1,6 @@
 services:
   autoteam:
     build: .
-    extra_hosts:
-      - "host.docker.internal:host-gateway"
     ports:
       - "8787:8787"
     volumes:

docs/configuration.md

@@ -14,9 +14,9 @@ cp .env.example .env
 | `CLOUDMAIL_EMAIL` | CloudMail 登录邮箱 | 是 |
 | `CLOUDMAIL_PASSWORD` | CloudMail 登录密码 | 是 |
 | `CLOUDMAIL_DOMAIN` | 临时邮箱域名（如 `@example.com`） | 是 |
-| `CPA_URL` | CLIProxyAPI 地址 | 否（默认 `http://127.0.0.1:8317`） |
+| `CPA_URL` | CLIProxyAPI 地址 | 是（留空使用默认 `http://127.0.0.1:8317`） |
 | `CPA_KEY` | CPA 管理密钥 | 是 |
-| `API_KEY` | Web 面板 / API 鉴权密钥 | 否（首次启动自动生成） |
+| `API_KEY` | Web 面板 / API 鉴权密钥 | 是（首次启动可自动生成） |
 | `PLAYWRIGHT_PROXY_URL` | Playwright 浏览器代理 URL，如 `socks5://user:pass@host:port` | 否 |
 | `PLAYWRIGHT_PROXY_BYPASS` | Playwright 代理绕过列表，如 `localhost,127.0.0.1` | 否 |
 | `AUTO_CHECK_THRESHOLD` | 额度低于此百分比触发轮转 | 否（默认 `10`） |

docs/getting-started.md

@@ -118,12 +118,7 @@ docker compose restart
 
 直接打开 `http://your-server:8787`，会显示配置向导页面，在浏览器中填写。
 
-如果你需要让浏览器流量走宿主机 SOCKS5 代理，在 Linux Docker 下还需要给容器增加：
-
-```yaml
-extra_hosts:
-  - "host.docker.internal:host-gateway"
-```
+如果你需要让浏览器流量走宿主机 SOCKS5 代理，请先确认容器内可以解析并访问宿主机代理地址（例如 `host.docker.internal`，或你自己提供的宿主机网关别名）。
 
 然后在 `data/.env` 中加入：
 

docs/troubleshooting.md

@@ -170,12 +170,7 @@ volumes:
 
 ### 容器里访问不到宿主机 SOCKS5 代理
 
-如果代理在宿主机上，比如 `host.docker.internal:1080`，Linux Docker 需要给容器补一条 host-gateway 映射：
-
-```yaml
-extra_hosts:
-  - "host.docker.internal:host-gateway"
-```
+如果代理在宿主机上，比如 `host.docker.internal:1080`，请先确认容器内可以解析并访问宿主机代理地址；不同 Docker / Podman 环境的宿主机别名配置方式可能不同。
 
 然后在 `data/.env` 中配置：
 

src/autoteam/api.py

@@ -101,9 +101,12 @@ def post_setup_save(config: SetupConfig):
     """保存配置到 .env 并验证连通性"""
     import secrets as _secrets
 
-    from autoteam.setup_wizard import _write_env
+    from autoteam.setup_wizard import REQUIRED_CONFIGS, _write_env
 
     data = config.model_dump()
+    defaults = {key: default for key, _prompt, default, _optional in REQUIRED_CONFIGS}
+    if not data.get("CPA_URL"):
+        data["CPA_URL"] = defaults.get("CPA_URL", "http://127.0.0.1:8317")
     if not data.get("API_KEY"):
         data["API_KEY"] = _secrets.token_urlsafe(24)
 

src/autoteam/setup_wizard.py

@@ -20,11 +20,11 @@ REQUIRED_CONFIGS = [
     ("CLOUDMAIL_EMAIL", "CloudMail 登录邮箱", "", False),
     ("CLOUDMAIL_PASSWORD", "CloudMail 登录密码", "", False),
     ("CLOUDMAIL_DOMAIN", "CloudMail 邮箱域名（如 @example.com）", "", False),
-    ("CPA_URL", "CPA (CLIProxyAPI) 地址", "http://127.0.0.1:8317", True),
+    ("CPA_URL", "CPA (CLIProxyAPI) 地址", "http://127.0.0.1:8317", False),
     ("CPA_KEY", "CPA 管理密钥", "", False),
     ("PLAYWRIGHT_PROXY_URL", "Playwright 浏览器代理 URL（可选，如 socks5://host:port）", "", True),
     ("PLAYWRIGHT_PROXY_BYPASS", "Playwright 代理绕过列表（可选，如 localhost,127.0.0.1）", "", True),
-    ("API_KEY", "API 鉴权密钥（回车自动生成）", "", True),
+    ("API_KEY", "API 鉴权密钥（回车自动生成）", "", False),
 ]
 
 

tests/unit/test_api_status.py

@@ -67,3 +67,38 @@ def test_sanitize_account_keeps_exportable_main_account_active_without_live_quot
 
     assert sanitized["is_main_account"] is True
     assert sanitized["status"] == "active"
+
+
+def test_post_setup_save_keeps_cpa_url_required_and_generates_api_key(monkeypatch):
+    written = {}
+
+    def fake_write_env(key, value):
+        written[key] = value
+
+    monkeypatch.setattr("autoteam.setup_wizard._write_env", fake_write_env)
+    monkeypatch.setattr("autoteam.setup_wizard._verify_cloudmail", lambda: True)
+    monkeypatch.setattr("autoteam.setup_wizard._verify_cpa", lambda: True)
+    monkeypatch.setattr("secrets.token_urlsafe", lambda _n: "generated-token")
+    monkeypatch.setattr("importlib.reload", lambda module: module)
+    monkeypatch.setattr(api, "API_KEY", "")
+    monkeypatch.delenv("CPA_URL", raising=False)
+    monkeypatch.delenv("API_KEY", raising=False)
+
+    result = api.post_setup_save(
+        api.SetupConfig(
+            CLOUDMAIL_BASE_URL="http://mail.example.com",
+            CLOUDMAIL_EMAIL="admin@example.com",
+            CLOUDMAIL_PASSWORD="secret",
+            CLOUDMAIL_DOMAIN="@example.com",
+            CPA_URL="",
+            CPA_KEY="key-1",
+            PLAYWRIGHT_PROXY_URL="",
+            PLAYWRIGHT_PROXY_BYPASS="",
+            API_KEY="",
+        )
+    )
+
+    assert written["CPA_URL"] == "http://127.0.0.1:8317"
+    assert written["API_KEY"] == "generated-token"
+    assert result["api_key"] == "generated-token"
+    assert api.API_KEY == "generated-token"

tests/unit/test_setup_wizard.py

@@ -81,8 +81,8 @@ def test_check_and_setup_non_interactive_reports_missing_required_fields(tmp_pat
     assert ok is False
     assert "[配置] 缺少必填项: CLOUDMAIL_BASE_URL" in caplog.text
     assert "[配置] 缺少必填项: CPA_KEY" in caplog.text
-    assert "[配置] 缺少必填项: CPA_URL" not in caplog.text
+    assert "[配置] 缺少必填项: CPA_URL" in caplog.text
     assert "[配置] 缺少必填项: PLAYWRIGHT_PROXY_URL" not in caplog.text
     assert "[配置] 缺少必填项: PLAYWRIGHT_PROXY_BYPASS" not in caplog.text
-    assert "[配置] 缺少必填项: API_KEY" not in caplog.text
+    assert "[配置] 缺少必填项: API_KEY" in caplog.text
     assert "[配置] 请通过 Web 面板或编辑 .env 文件填入配置" in caplog.text