update sth at 2025-10-16 15:32:02

app/admin/api.py

@@ -194,7 +194,7 @@ async def save_config(request: Request):
             "",
             "# ========== 服务器配置 ==========",
             f"SERVICE_NAME={form_data.get('service_name', 'Z.AI2API')}",
-            f"LISTEN_PORT={form_data.get('listen_port', '7860')}",
+            f"LISTEN_PORT={form_data.get('listen_port', '8080')}",
             f"DEBUG_LOGGING={'true' if 'debug_logging' in form_data else 'false'}",
             "",
             "# ========== 认证配置 ==========",

app/core/config.py

@@ -54,7 +54,7 @@ class Settings(BaseSettings):
         }
 
     # Server Configuration
-    LISTEN_PORT: int = int(os.getenv("LISTEN_PORT", "7860"))
+    LISTEN_PORT: int = int(os.getenv("LISTEN_PORT", "8080"))
     DEBUG_LOGGING: bool = os.getenv("DEBUG_LOGGING", "true").lower() == "true"
     SERVICE_NAME: str = os.getenv("SERVICE_NAME", "z-ai2api-server")
     ROOT_PATH: str = os.getenv("ROOT_PATH", "")  # For Nginx reverse proxy path prefix, e.g., "/api" or "/path-prefix"

app/core/openai.py

@@ -93,8 +93,6 @@ async def handle_non_stream_response(stream_response, request: OpenAIRequest) ->
 
 
 @router.get("/v1/models")
-@router.get("/api/v1/models")
-@router.get("/hf/v1/models")
 async def list_models():
     """List available models from all providers"""
     try:
@@ -117,8 +115,6 @@ async def list_models():
 
 
 @router.post("/v1/chat/completions")
-@router.post("/api/v1/chat/completions")
-@router.post("/hf/v1/chat/completions")
 async def chat_completions(request: OpenAIRequest, authorization: str = Header(...)):
     """Handle chat completion requests with multi-provider architecture"""
     role = request.messages[0].role if request.messages else "unknown"

deploy/.env.example

@@ -32,4 +32,4 @@ TOKEN_RECOVERY_TIMEOUT=300
 
 # 服务配置
 SERVICE_NAME=Z.AI_API_Server
-LISTEN_PORT=7860
+LISTEN_PORT=8080

deploy/Dockerfile

@@ -18,7 +18,7 @@ COPY . .
 ENV DB_PATH=/app/data/tokens.db
 
 # Expose port
-EXPOSE 7860
+EXPOSE 8080
 
 # Run the application
 CMD ["python", "main.py"]

deploy/NGINX_SETUP.md

@@ -37,7 +37,7 @@ server {
 
     location /ai2api {
         # 代理到后端服务
-        proxy_pass http://127.0.0.1:7860;
+        proxy_pass http://127.0.0.1:8080;
 
         # 传递原始请求信息
         proxy_set_header Host $host;
@@ -69,10 +69,10 @@ services:
     image: z-ai2api:latest
     environment:
       - ROOT_PATH=/ai2api
-      - LISTEN_PORT=7860
+      - LISTEN_PORT=8080
       # ... 其他环境变量
     ports:
-      - "7860:7860"
+      - "8080:8080"
 ```
 
 ### 4. 重启服务
@@ -110,7 +110,7 @@ ROOT_PATH=/api
 **Nginx 配置**:
 ```nginx
 location /api {
-    proxy_pass http://127.0.0.1:7860;
+    proxy_pass http://127.0.0.1:8080;
     # ... 其他配置
 }
 ```
@@ -127,7 +127,7 @@ ROOT_PATH=
 **Nginx 配置**:
 ```nginx
 location / {
-    proxy_pass http://127.0.0.1:7860;
+    proxy_pass http://127.0.0.1:8080;
     # ... 其他配置
 }
 ```
@@ -144,7 +144,7 @@ ROOT_PATH=/services/ai/chat
 **Nginx 配置**:
 ```nginx
 location /services/ai/chat {
-    proxy_pass http://127.0.0.1:7860;
+    proxy_pass http://127.0.0.1:8080;
     # ... 其他配置
 }
 ```
@@ -246,7 +246,7 @@ server {
     ssl_certificate_key /path/to/key.pem;
 
     location /ai2api {
-        proxy_pass http://127.0.0.1:7860;
+        proxy_pass http://127.0.0.1:8080;
         proxy_set_header X-Forwarded-Proto https;
         # ... 其他配置
     }
@@ -257,7 +257,7 @@ server {
 
 ```nginx
 upstream ai2api_backend {
-    server 127.0.0.1:7860;
+    server 127.0.0.1:8080;
     server 127.0.0.1:8081;
     server 127.0.0.1:8082;
 }

deploy/README_DOCKER.md

@@ -16,7 +16,7 @@ mkdir -p data logs
 # 快速启动
 docker run -d \
   --name z-ai-api-server \
-  -p 7860:7860 \
+  -p 8080:8080 \
   -e ADMIN_PASSWORD=admin123 \
   -e AUTH_TOKEN=sk-your-api-key \
   -e ANONYMOUS_MODE=true \
@@ -48,7 +48,7 @@ docker compose up -d
 docker compose logs -f api-server
 ```
 
-服务将在 `http://localhost:7860` 启动。
+服务将在 `http://localhost:8080` 启动。
 
 ## 架构说明
 
@@ -222,10 +222,10 @@ docker compose config
 
 ### 端口冲突
 
-如端口 7860 被占用,修改 `docker-compose.yml`:
+如端口 8080 被占用,修改 `docker-compose.yml`:
 ```yaml
 ports:
-  - "8081:7860"  # 映射到宿主机 8081 端口
+  - "8081:8080"  # 映射到宿主机 8081 端口
 ```
 
 ### 健康检查失败
@@ -235,7 +235,7 @@ ports:
 docker compose ps
 
 # 手动测试接口
-curl http://localhost:7860/v1/models
+curl http://localhost:8080/v1/models
 
 # 进入容器排查
 docker exec -it z-ai-api-server bash
@@ -245,11 +245,11 @@ docker exec -it z-ai-api-server bash
 
 | 端点 | 地址 | 说明 |
 |------|------|------|
-| API 根路径 | `http://localhost:7860` | OpenAI 兼容 API |
-| 模型列表 | `http://localhost:7860/v1/models` | 获取可用模型 |
-| 管理后台 | `http://localhost:7860/admin` | Web 管理界面 |
-| API 文档 | `http://localhost:7860/docs` | OpenAPI/Swagger 文档 |
-| 健康检查 | `http://localhost:7860/v1/models` | 服务健康状态 |
+| API 根路径 | `http://localhost:8080` | OpenAI 兼容 API |
+| 模型列表 | `http://localhost:8080/v1/models` | 获取可用模型 |
+| 管理后台 | `http://localhost:8080/admin` | Web 管理界面 |
+| API 文档 | `http://localhost:8080/docs` | OpenAPI/Swagger 文档 |
+| 健康检查 | `http://localhost:8080/v1/models` | 服务健康状态 |
 
 ## 高级配置
 

deploy/docker-compose.yml

@@ -5,7 +5,7 @@ services:
       dockerfile: deploy/Dockerfile
     container_name: z-ai-api-server
     ports:
-      - "7860:7860"
+      - "8080:8080"
     volumes:
       # 数据库持久化存储
       - ./data:/app/data
@@ -29,7 +29,7 @@ services:
       - DB_PATH=/app/data/tokens.db
     restart: unless-stopped
     healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:7860/v1/models"]
+      test: ["CMD", "curl", "-f", "http://localhost:8080/v1/models"]
       interval: 30s
       timeout: 10s
       retries: 3

deploy/nginx.conf.example

@@ -12,7 +12,7 @@ server {
         rewrite ^(/ai2api)$ $1/ permanent;
 
         # Proxy to the backend service
-        proxy_pass http://127.0.0.1:7860;
+        proxy_pass http://127.0.0.1:8080;
 
         # Pass original host and IP information
         proxy_set_header Host $host;
@@ -47,7 +47,7 @@ server {
 
     location /api/chat {
         # Proxy configuration
-        proxy_pass http://127.0.0.1:7860;
+        proxy_pass http://127.0.0.1:8080;
 
         # Headers
         proxy_set_header Host $host;
@@ -75,7 +75,7 @@ server {
     ssl_certificate_key /path/to/key.pem;
 
     location /ai2api {
-        proxy_pass http://127.0.0.1:7860;
+        proxy_pass http://127.0.0.1:8080;
 
         proxy_set_header Host $host;
         proxy_set_header X-Real-IP $remote_addr;
@@ -100,7 +100,7 @@ server {
 # Example 4: Load balancing with multiple backend instances
 upstream ai2api_backend {
     # Round-robin by default
-    server 127.0.0.1:7860;
+    server 127.0.0.1:8080;
     server 127.0.0.1:8081;
     server 127.0.0.1:8082;
 
@@ -148,7 +148,7 @@ server {
 #
 # 4. For Docker deployments, make sure to:
 #    - Add ROOT_PATH to docker-compose.yml environment variables
-#    - Expose the container port (7860 by default)
+#    - Expose the container port (8080 by default)
 #
 # 5. Common issues:
 #    - 404 errors: Check that ROOT_PATH matches the Nginx location path exactly

nginx.conf

@@ -0,0 +1,157 @@
+# Nginx reverse proxy configuration example for Z.AI2API
+# This example shows how to deploy the service behind Nginx with a custom path prefix
+
+# Example 1: Deploy at http://your-domain.com/ai2api
+server {
+    listen 80;
+    server_name your-domain.com;
+
+    # Forward requests with /ai2api prefix to the backend service
+    location /ai2api {
+        # Remove trailing slash redirect (optional, but recommended)
+        rewrite ^(/ai2api)$ $1/ permanent;
+
+        # Proxy to the backend service
+        proxy_pass http://127.0.0.1:7860;
+
+        # Pass original host and IP information
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+
+        # IMPORTANT: Tell the backend about the path prefix
+        # This ensures all generated URLs include the prefix
+        proxy_set_header X-Forwarded-Prefix /ai2api;
+
+        # WebSocket and SSE support (for streaming responses)
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+
+        # Disable buffering for streaming responses
+        proxy_buffering off;
+        proxy_cache off;
+
+        # Timeout settings (adjust as needed)
+        proxy_connect_timeout 60s;
+        proxy_send_timeout 300s;
+        proxy_read_timeout 300s;
+    }
+}
+
+# Example 2: Deploy at http://your-domain.com/api/chat
+server {
+    listen 80;
+    server_name example.com;
+
+    location /api/chat {
+        # Proxy configuration
+        proxy_pass http://127.0.0.1:7860;
+
+        # Headers
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_set_header X-Forwarded-Prefix /api/chat;
+
+        # SSE/WebSocket support
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_buffering off;
+        proxy_cache off;
+    }
+}
+
+# Example 3: Deploy with SSL (HTTPS)
+server {
+    listen 443 ssl http2;
+    server_name secure.example.com;
+
+    # SSL configuration
+    ssl_certificate /path/to/cert.pem;
+    ssl_certificate_key /path/to/key.pem;
+
+    location /ai2api {
+        proxy_pass http://127.0.0.1:7860;
+
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto https;
+        proxy_set_header X-Forwarded-Prefix /ai2api;
+
+        # SSE/WebSocket support
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_buffering off;
+        proxy_cache off;
+
+        # Security headers (optional)
+        add_header X-Content-Type-Options nosniff;
+        add_header X-Frame-Options DENY;
+        add_header X-XSS-Protection "1; mode=block";
+    }
+}
+
+# Example 4: Load balancing with multiple backend instances
+upstream ai2api_backend {
+    # Round-robin by default
+    server 127.0.0.1:7860;
+    server 127.0.0.1:8081;
+    server 127.0.0.1:8082;
+
+    # Or use least connections
+    # least_conn;
+
+    # Or use IP hash for session persistence
+    # ip_hash;
+}
+
+server {
+    listen 80;
+    server_name loadbalanced.example.com;
+
+    location /ai2api {
+        proxy_pass http://ai2api_backend;
+
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_set_header X-Forwarded-Prefix /ai2api;
+
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_buffering off;
+        proxy_cache off;
+    }
+}
+
+# Important Notes:
+#
+# 1. Set ROOT_PATH in your .env file to match the Nginx location path:
+#    ROOT_PATH=/ai2api
+#
+# 2. Restart both Nginx and the application after configuration changes:
+#    sudo systemctl reload nginx
+#    docker-compose restart (or restart your application)
+#
+# 3. Access URLs will include the prefix:
+#    - Admin panel: http://your-domain.com/ai2api/admin/login
+#    - API endpoint: http://your-domain.com/ai2api/v1/chat/completions
+#    - Health check: http://your-domain.com/ai2api/v1/models
+#
+# 4. For Docker deployments, make sure to:
+#    - Add ROOT_PATH to docker-compose.yml environment variables
+#    - Expose the container port (7860 by default)
+#
+# 5. Common issues:
+#    - 404 errors: Check that ROOT_PATH matches the Nginx location path exactly
+#    - CORS errors: Verify proxy headers are set correctly
+#    - Streaming not working: Ensure proxy_buffering is off
+#    - Admin panel CSS/JS not loading: Confirm static files are served with the prefix