解决域名问题

2026-06-15 23:01:31 +08:00
parent 9b3a3ee1b0
commit 850aeb4672
3 changed files with 114 additions and 1 deletions
@@ -431,6 +431,24 @@ docker compose --env-file .env.prod -f docker-compose.prod.yml up -d --build fro

 ---

+## 16. 备选：IP:端口模式（无域名 / 无 SSL）
+
+若不用域名 / 证书（域名被占用、或临时测试），可直接用 `http://<VPS-IP>:8088` 访问。**容器配置完全不变**（仍绑定 127.0.0.1），只需让宿主机 Nginx 在一个公开端口上做 HTTP 反代，并**跳过 certbot**。配置见 [deploy/nginx-ipport.conf](deploy/nginx-ipport.conf)（监听 8088、`server_name _`、反代到 127.0.0.1:8080/8000；与域名模式的 `deploy/nginx.conf` 用了不同端口与不同 upstream 名，互不冲突，可共存）。
+
+部署命令（在 `/opt/qingye/chat`）：
+
+```bash
+sudo cp deploy/nginx-ipport.conf /etc/nginx/sites-available/qingye-ipport.conf && sudo ln -sf /etc/nginx/sites-available/qingye-ipport.conf /etc/nginx/sites-enabled/ && sudo nginx -t && sudo systemctl reload nginx && sudo ufw allow 8088/tcp
+```
+
+随后浏览器打开 `http://103.170.72.162:8088`。前端域名无关（同源 `/api/v1`、按页面协议推导 `ws://`），HTTP 下照常工作；浏览器提示「不安全」属正常。
+
+> **换端口**：把 `nginx-ipport.conf` 里唯一的 `listen 8088` 与 `ufw allow 8088/tcp` 中的 `8088` 一并改掉即可。
+> **CORS**：同源访问不触发 CORS，`.env.prod` 的 `CORS_ORIGINS` 无需改也能用；想精确匹配可设为 `http://103.170.72.162:8088` 再 `docker compose -f docker-compose.prod.yml restart backend`。
+> **以后拿到域名**：启用第 7、8 节的 `deploy/nginx.conf` + certbot，IP:端口配置可保留或删除。
+
+---
+
 ## 附：开发环境（本机）

 开发环境与本指南的生产环境**完全独立**，命令不变：
@@ -1,3 +1,5 @@

 计划将这个项目部署到生产环境，域名为www.e4s.world，使用Nginx作为反向代理，使用Docker Compose作为容器编排。VPS的IP为：103.170.72.162。请修改相关代码，以便项目能区分生产环境和开发环境。
 之后，生成一个md文件，告知如何在VPS中执行部署命令。VPS的OS是Ubuntu 20.04。安装了nginx，但其他必要的软件包未安装。
+
+本地自测通过了。但这个VPS之前申请过证书，并且域名www.e4s.world可能被占用了。所以我计划直接用IP地址和端口的形式部署这个qingye的服务。请修改相关设置，并给出后续部署的命令。
@@ -0,0 +1,93 @@
+# ============================================================
+# 青叶 (QingYe) —— 宿主机 Nginx 反向代理（IP:端口 模式，无 SSL）
+# ------------------------------------------------------------
+# 适用：无域名 / 不用证书，直接用 http://<VPS-IP>:8088 访问。
+# 访问地址：http://103.170.72.162:8088
+#
+# 与域名模式的 deploy/nginx.conf 互不冲突（端口不同、upstream 名不同），
+# 二者可同时存在；以后拿到域名时改用 deploy/nginx.conf + certbot 即可。
+#
+# 部署：
+#   sudo cp deploy/nginx-ipport.conf /etc/nginx/sites-available/qingye-ipport.conf
+#   sudo ln -sf /etc/nginx/sites-available/qingye-ipport.conf /etc/nginx/sites-enabled/
+#   sudo nginx -t && sudo systemctl reload nginx
+#   sudo ufw allow 8088/tcp
+#
+# 想换端口：把下面唯一的 listen 8088 与上面的 ufw allow 8088/tcp 改掉即可。
+#
+# 流量走向：
+#   http://<IP>:8088/          → 127.0.0.1:8080  (前端容器, SPA)
+#   http://<IP>:8088/api/...   → 127.0.0.1:8000  (后端容器)
+#   http://<IP>:8088/uploads/  → 127.0.0.1:8000  (后端 StaticFiles)
+#   ws://<IP>:8088/ws          → 127.0.0.1:8000  (后端 WebSocket)
+# ============================================================
+
+upstream qingye_frontend_ipport {
+    server 127.0.0.1:8080;
+}
+
+upstream qingye_backend_ipport {
+    server 127.0.0.1:8000;
+}
+
+server {
+    listen 8088;            # ← 公开端口，可改
+    server_name _;          # 接受任意 Host（含 IP）
+
+    # 上传体积上限：须 >= 后端 MAX_UPLOAD_SIZE_MB（默认 10MB），此处留余量
+    client_max_body_size 12M;
+
+    # 基础安全响应头（无 HTTPS，故不加 HSTS）
+    add_header X-Frame-Options "SAMEORIGIN" always;
+    add_header X-Content-Type-Options "nosniff" always;
+
+    # ---- 前端 SPA（默认路由，最低优先级）----
+    location / {
+        proxy_pass http://qingye_frontend_ipport;
+        proxy_http_version 1.1;
+        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;
+    }
+
+    # ---- API 接口（proxy_pass 不带尾部斜杠，保留 /api/ 前缀）----
+    location /api/ {
+        proxy_pass http://qingye_backend_ipport;
+        proxy_http_version 1.1;
+        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;
+    }
+
+    # ---- 上传文件（后端 StaticFiles 挂载于 /uploads）----
+    location /uploads/ {
+        proxy_pass http://qingye_backend_ipport;
+        proxy_http_version 1.1;
+        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;
+        add_header X-Content-Type-Options "nosniff" always;
+        expires 7d;
+        access_log off;
+    }
+
+    # ---- WebSocket（精确匹配 /ws，优先级高于 location /）----
+    location = /ws {
+        proxy_pass http://qingye_backend_ipport;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        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_read_timeout 86400s;
+        proxy_send_timeout 86400s;
+        # 不记录含 token 的查询串
+        access_log off;
+    }
+}