init: ALiYunManager 基础设施项目 — nginx配置/docker-compose/部署文档

2026-05-16 23:27:24 +08:00
commit 0413d2715c
28 changed files with 2590 additions and 0 deletions
@@ -0,0 +1,122 @@
+# 快速开始指南
+
+## 方案一：完整部署（所有服务一起管理）
+
+适用于所有服务代码都在同一个项目中管理。
+
+### 1. 初始化服务器（如果是新服务器）
+
+```bash
+ssh -i "小程序连接.pem" root@8.136.137.59
+cd /opt
+git clone <你的仓库地址> ALiYunManager
+cd ALiYunManager
+./scripts/init-server.sh
+```
+
+### 2. 部署所有服务
+
+```bash
+./deploy.sh
+```
+
+### 3. 配置 DNS
+
+在阿里云域名控制台添加解析：
+
+| 记录类型 | 主机记录 | 记录值 |
+|---------|---------|--------|
+| A | me | 8.136.137.59 |
+| A | www | 8.136.137.59 |
+| A | api-resume | 8.136.137.59 |
+| A | api-miniapp | 8.136.137.59 |
+
+### 4. 配置 HTTPS
+
+```bash
+./scripts/setup-ssl.sh
+```
+
+按提示修改 `nginx/conf.d/` 下的配置文件启用 443 端口。
+
+---
+
+## 方案二：仅部署主 Nginx（各服务独立管理）
+
+适用于各服务由不同项目/仓库管理，独立部署。
+
+### 1. 部署主 Nginx
+
+```bash
+docker-compose -f docker-compose.main-nginx-only.yml up -d
+```
+
+### 2. 各服务独立部署
+
+每个服务在自己的目录下有独立的 `docker-compose.yml`，例如：
+
+```yaml
+# services/resume-web/docker-compose.yml
+version: "3.8"
+services:
+  resume-web:
+    image: nginx:alpine
+    container_name: resume-web
+    restart: always
+    ports:
+      - "8081:80"
+    volumes:
+      - ./html:/usr/share/nginx/html:ro
+      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
+    networks:
+      - aliyun-app-network
+
+networks:
+  aliyun-app-network:
+    external: true
+```
+
+主 Nginx 通过端口 `8081` 反向代理到该服务。
+
+---
+
+## 常用操作
+
+```bash
+# 查看所有容器状态
+docker-compose ps
+
+# 查看主 Nginx 日志
+docker-compose logs -f nginx
+
+# 查看某个服务日志
+docker-compose logs -f resume-web
+
+# 重启某个服务
+docker-compose restart resume-web
+
+# 重载 Nginx 配置（不重启容器）
+docker-compose exec nginx nginx -s reload
+
+# 更新单个服务
+./scripts/update-service.sh resume-web
+
+# 进入容器调试
+docker-compose exec nginx sh
+docker-compose exec resume-web sh
+```
+
+---
+
+## 文件说明
+
+| 文件/目录 | 说明 |
+|-----------|------|
+| `docker-compose.yml` | 完整部署配置（含示例服务） |
+| `docker-compose.main-nginx-only.yml` | 仅主 Nginx |
+| `nginx/nginx.conf` | 主 Nginx 核心配置 |
+| `nginx/conf.d/*.conf` | 各服务的反向代理配置 |
+| `nginx/ssl/` | SSL 证书目录 |
+| `services/服务名/` | 各服务独立配置 |
+| `scripts/` | 辅助脚本 |
+| `.env` | 环境变量配置 |