docs(admin-web): 添加 Nginx 完整安装脚本和文档
- install.sh: 从零开始的一键安装脚本 (系统更新、Nginx、Certbot、SSL) - README.md: 详细的手动安装步骤和常用命令 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Developer
parent
7fcedf7e08
commit
e2047cc2c3
|
|
@ -0,0 +1,166 @@
|
||||||
|
# Nginx 配置说明
|
||||||
|
|
||||||
|
## 快速部署
|
||||||
|
|
||||||
|
### 前提条件
|
||||||
|
|
||||||
|
1. 一台 Ubuntu/Debian 服务器
|
||||||
|
2. 域名 `rwaadmin.szaiai.com` 的 DNS A 记录已指向服务器 IP
|
||||||
|
3. 防火墙开放 80 和 443 端口
|
||||||
|
|
||||||
|
### 一键安装
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. 上传项目到服务器
|
||||||
|
scp -r ./admin-web user@server:/opt/
|
||||||
|
|
||||||
|
# 2. SSH 登录服务器
|
||||||
|
ssh user@server
|
||||||
|
|
||||||
|
# 3. 运行 Nginx 安装脚本
|
||||||
|
cd /opt/admin-web/nginx
|
||||||
|
sudo chmod +x install.sh
|
||||||
|
sudo ./install.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
## 手动安装步骤
|
||||||
|
|
||||||
|
### 1. 安装 Nginx 和 Certbot
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo apt update && sudo apt upgrade -y
|
||||||
|
sudo apt install -y nginx certbot python3-certbot-nginx
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 配置防火墙
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo ufw allow 'Nginx Full'
|
||||||
|
sudo ufw allow OpenSSH
|
||||||
|
sudo ufw enable
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 创建 Nginx 配置
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 复制配置文件
|
||||||
|
sudo cp rwaadmin.szaiai.com.conf /etc/nginx/sites-available/rwaadmin.szaiai.com
|
||||||
|
|
||||||
|
# 启用站点
|
||||||
|
sudo ln -s /etc/nginx/sites-available/rwaadmin.szaiai.com /etc/nginx/sites-enabled/
|
||||||
|
|
||||||
|
# 删除默认站点 (可选)
|
||||||
|
sudo rm /etc/nginx/sites-enabled/default
|
||||||
|
|
||||||
|
# 测试配置
|
||||||
|
sudo nginx -t
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. 申请 SSL 证书
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 创建验证目录
|
||||||
|
sudo mkdir -p /var/www/certbot
|
||||||
|
|
||||||
|
# 先创建临时 HTTP 配置用于验证
|
||||||
|
# (或使用 certbot --nginx 自动配置)
|
||||||
|
|
||||||
|
# 申请证书
|
||||||
|
sudo certbot certonly --webroot -w /var/www/certbot -d rwaadmin.szaiai.com
|
||||||
|
|
||||||
|
# 或使用 Nginx 插件自动配置
|
||||||
|
sudo certbot --nginx -d rwaadmin.szaiai.com
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. 重载 Nginx
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo nginx -t && sudo systemctl reload nginx
|
||||||
|
```
|
||||||
|
|
||||||
|
## 证书管理
|
||||||
|
|
||||||
|
### 查看证书
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo certbot certificates
|
||||||
|
```
|
||||||
|
|
||||||
|
### 手动续期
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo certbot renew
|
||||||
|
```
|
||||||
|
|
||||||
|
### 测试续期
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo certbot renew --dry-run
|
||||||
|
```
|
||||||
|
|
||||||
|
### 自动续期
|
||||||
|
|
||||||
|
Certbot 会自动创建 systemd timer 进行证书续期：
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 查看 timer 状态
|
||||||
|
sudo systemctl status certbot.timer
|
||||||
|
|
||||||
|
# 查看续期日志
|
||||||
|
sudo journalctl -u certbot
|
||||||
|
```
|
||||||
|
|
||||||
|
## 常用命令
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Nginx 状态
|
||||||
|
sudo systemctl status nginx
|
||||||
|
|
||||||
|
# 启动/停止/重启
|
||||||
|
sudo systemctl start nginx
|
||||||
|
sudo systemctl stop nginx
|
||||||
|
sudo systemctl restart nginx
|
||||||
|
|
||||||
|
# 重载配置 (不中断服务)
|
||||||
|
sudo systemctl reload nginx
|
||||||
|
|
||||||
|
# 测试配置语法
|
||||||
|
sudo nginx -t
|
||||||
|
|
||||||
|
# 查看访问日志
|
||||||
|
sudo tail -f /var/log/nginx/rwaadmin.szaiai.com.access.log
|
||||||
|
|
||||||
|
# 查看错误日志
|
||||||
|
sudo tail -f /var/log/nginx/rwaadmin.szaiai.com.error.log
|
||||||
|
```
|
||||||
|
|
||||||
|
## 文件结构
|
||||||
|
|
||||||
|
```
|
||||||
|
nginx/
|
||||||
|
├── README.md # 本文档
|
||||||
|
├── install.sh # 一键安装脚本
|
||||||
|
├── setup-ssl.sh # SSL 配置脚本
|
||||||
|
└── rwaadmin.szaiai.com.conf # Nginx 站点配置
|
||||||
|
```
|
||||||
|
|
||||||
|
## 故障排除
|
||||||
|
|
||||||
|
### 1. 证书申请失败
|
||||||
|
|
||||||
|
- 确认域名 DNS 已正确解析到服务器 IP
|
||||||
|
- 确认 80 端口可访问
|
||||||
|
- 检查 `/var/www/certbot` 目录权限
|
||||||
|
|
||||||
|
### 2. 502 Bad Gateway
|
||||||
|
|
||||||
|
- 确认 Docker 容器正在运行: `docker ps`
|
||||||
|
- 确认应用监听 3000 端口: `curl localhost:3000`
|
||||||
|
|
||||||
|
### 3. 证书过期
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 手动续期
|
||||||
|
sudo certbot renew --force-renewal
|
||||||
|
sudo systemctl reload nginx
|
||||||
|
```
|
||||||
|
|
@ -0,0 +1,305 @@
|
||||||
|
#!/bin/bash
|
||||||
|
# RWADurian Admin Web - Nginx 完整安装脚本
|
||||||
|
# 适用于全新 Ubuntu/Debian 服务器
|
||||||
|
|
||||||
|
set -e
|
||||||
|
|
||||||
|
DOMAIN="rwaadmin.szaiai.com"
|
||||||
|
EMAIL="admin@szaiai.com" # 修改为你的邮箱
|
||||||
|
APP_PORT=3000
|
||||||
|
|
||||||
|
# 颜色
|
||||||
|
RED='\033[0;31m'
|
||||||
|
GREEN='\033[0;32m'
|
||||||
|
YELLOW='\033[1;33m'
|
||||||
|
BLUE='\033[0;34m'
|
||||||
|
NC='\033[0m'
|
||||||
|
|
||||||
|
log_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
|
||||||
|
log_success() { echo -e "${GREEN}[SUCCESS]${NC} $1"; }
|
||||||
|
log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
|
||||||
|
log_error() { echo -e "${RED}[ERROR]${NC} $1"; }
|
||||||
|
|
||||||
|
# 检查 root 权限
|
||||||
|
check_root() {
|
||||||
|
if [ "$EUID" -ne 0 ]; then
|
||||||
|
log_error "请使用 root 权限运行: sudo ./install.sh"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# 步骤 1: 更新系统
|
||||||
|
update_system() {
|
||||||
|
log_info "步骤 1/6: 更新系统包..."
|
||||||
|
apt update && apt upgrade -y
|
||||||
|
log_success "系统更新完成"
|
||||||
|
}
|
||||||
|
|
||||||
|
# 步骤 2: 安装 Nginx
|
||||||
|
install_nginx() {
|
||||||
|
log_info "步骤 2/6: 安装 Nginx..."
|
||||||
|
apt install -y nginx
|
||||||
|
systemctl enable nginx
|
||||||
|
systemctl start nginx
|
||||||
|
log_success "Nginx 安装完成"
|
||||||
|
}
|
||||||
|
|
||||||
|
# 步骤 3: 安装 Certbot
|
||||||
|
install_certbot() {
|
||||||
|
log_info "步骤 3/6: 安装 Certbot..."
|
||||||
|
apt install -y certbot python3-certbot-nginx
|
||||||
|
log_success "Certbot 安装完成"
|
||||||
|
}
|
||||||
|
|
||||||
|
# 步骤 4: 配置 Nginx (HTTP)
|
||||||
|
configure_nginx_http() {
|
||||||
|
log_info "步骤 4/6: 配置 Nginx (HTTP 临时配置用于证书申请)..."
|
||||||
|
|
||||||
|
# 创建 certbot webroot 目录
|
||||||
|
mkdir -p /var/www/certbot
|
||||||
|
|
||||||
|
# 创建临时 HTTP 配置
|
||||||
|
cat > /etc/nginx/sites-available/$DOMAIN << EOF
|
||||||
|
# 临时 HTTP 配置 - 用于 Let's Encrypt 验证
|
||||||
|
server {
|
||||||
|
listen 80;
|
||||||
|
listen [::]:80;
|
||||||
|
server_name $DOMAIN;
|
||||||
|
|
||||||
|
# Let's Encrypt 验证目录
|
||||||
|
location /.well-known/acme-challenge/ {
|
||||||
|
root /var/www/certbot;
|
||||||
|
}
|
||||||
|
|
||||||
|
# 临时代理到应用
|
||||||
|
location / {
|
||||||
|
proxy_pass http://127.0.0.1:$APP_PORT;
|
||||||
|
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;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
EOF
|
||||||
|
|
||||||
|
# 启用站点
|
||||||
|
ln -sf /etc/nginx/sites-available/$DOMAIN /etc/nginx/sites-enabled/
|
||||||
|
|
||||||
|
# 删除默认站点 (可选)
|
||||||
|
rm -f /etc/nginx/sites-enabled/default
|
||||||
|
|
||||||
|
# 测试并重载
|
||||||
|
nginx -t && systemctl reload nginx
|
||||||
|
log_success "Nginx HTTP 配置完成"
|
||||||
|
}
|
||||||
|
|
||||||
|
# 步骤 5: 申请 SSL 证书
|
||||||
|
obtain_ssl_certificate() {
|
||||||
|
log_info "步骤 5/6: 申请 Let's Encrypt SSL 证书..."
|
||||||
|
|
||||||
|
# 检查域名解析
|
||||||
|
log_info "检查域名 $DOMAIN 解析..."
|
||||||
|
if ! host $DOMAIN > /dev/null 2>&1; then
|
||||||
|
log_warn "无法解析域名 $DOMAIN，请确保 DNS 已正确配置"
|
||||||
|
log_warn "继续尝试申请证书..."
|
||||||
|
fi
|
||||||
|
|
||||||
|
# 申请证书
|
||||||
|
certbot certonly \
|
||||||
|
--webroot \
|
||||||
|
--webroot-path=/var/www/certbot \
|
||||||
|
--email $EMAIL \
|
||||||
|
--agree-tos \
|
||||||
|
--no-eff-email \
|
||||||
|
-d $DOMAIN
|
||||||
|
|
||||||
|
log_success "SSL 证书申请成功"
|
||||||
|
}
|
||||||
|
|
||||||
|
# 步骤 6: 配置 Nginx (HTTPS)
|
||||||
|
configure_nginx_https() {
|
||||||
|
log_info "步骤 6/6: 配置 Nginx (HTTPS)..."
|
||||||
|
|
||||||
|
# 复制完整的 HTTPS 配置
|
||||||
|
cat > /etc/nginx/sites-available/$DOMAIN << 'NGINX_CONF'
|
||||||
|
# RWADurian Admin Web Nginx 配置
|
||||||
|
# 域名: rwaadmin.szaiai.com
|
||||||
|
|
||||||
|
# HTTP 重定向到 HTTPS
|
||||||
|
server {
|
||||||
|
listen 80;
|
||||||
|
listen [::]:80;
|
||||||
|
server_name rwaadmin.szaiai.com;
|
||||||
|
|
||||||
|
# Let's Encrypt 验证目录
|
||||||
|
location /.well-known/acme-challenge/ {
|
||||||
|
root /var/www/certbot;
|
||||||
|
}
|
||||||
|
|
||||||
|
# 重定向到 HTTPS
|
||||||
|
location / {
|
||||||
|
return 301 https://$host$request_uri;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
# HTTPS 配置
|
||||||
|
server {
|
||||||
|
listen 443 ssl http2;
|
||||||
|
listen [::]:443 ssl http2;
|
||||||
|
server_name rwaadmin.szaiai.com;
|
||||||
|
|
||||||
|
# SSL 证书 (Let's Encrypt)
|
||||||
|
ssl_certificate /etc/letsencrypt/live/rwaadmin.szaiai.com/fullchain.pem;
|
||||||
|
ssl_certificate_key /etc/letsencrypt/live/rwaadmin.szaiai.com/privkey.pem;
|
||||||
|
|
||||||
|
# SSL 配置优化
|
||||||
|
ssl_session_timeout 1d;
|
||||||
|
ssl_session_cache shared:SSL:50m;
|
||||||
|
ssl_session_tickets off;
|
||||||
|
|
||||||
|
# 现代加密套件
|
||||||
|
ssl_protocols TLSv1.2 TLSv1.3;
|
||||||
|
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
|
||||||
|
ssl_prefer_server_ciphers off;
|
||||||
|
|
||||||
|
# HSTS
|
||||||
|
add_header Strict-Transport-Security "max-age=63072000" always;
|
||||||
|
|
||||||
|
# 日志
|
||||||
|
access_log /var/log/nginx/rwaadmin.szaiai.com.access.log;
|
||||||
|
error_log /var/log/nginx/rwaadmin.szaiai.com.error.log;
|
||||||
|
|
||||||
|
# Gzip 压缩
|
||||||
|
gzip on;
|
||||||
|
gzip_vary on;
|
||||||
|
gzip_proxied any;
|
||||||
|
gzip_comp_level 6;
|
||||||
|
gzip_types text/plain text/css text/xml application/json application/javascript application/rss+xml application/atom+xml image/svg+xml;
|
||||||
|
|
||||||
|
# 安全头
|
||||||
|
add_header X-Frame-Options "SAMEORIGIN" always;
|
||||||
|
add_header X-Content-Type-Options "nosniff" always;
|
||||||
|
add_header X-XSS-Protection "1; mode=block" always;
|
||||||
|
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
|
||||||
|
|
||||||
|
# 反向代理到 Docker 容器
|
||||||
|
location / {
|
||||||
|
proxy_pass http://127.0.0.1:3000;
|
||||||
|
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_cache_bypass $http_upgrade;
|
||||||
|
|
||||||
|
# 超时设置
|
||||||
|
proxy_connect_timeout 60s;
|
||||||
|
proxy_send_timeout 60s;
|
||||||
|
proxy_read_timeout 60s;
|
||||||
|
}
|
||||||
|
|
||||||
|
# 健康检查端点
|
||||||
|
location /api/health {
|
||||||
|
proxy_pass http://127.0.0.1:3000;
|
||||||
|
proxy_http_version 1.1;
|
||||||
|
proxy_set_header Host $host;
|
||||||
|
proxy_set_header X-Real-IP $remote_addr;
|
||||||
|
access_log off;
|
||||||
|
}
|
||||||
|
|
||||||
|
# 静态资源缓存
|
||||||
|
location /_next/static {
|
||||||
|
proxy_pass http://127.0.0.1:3000;
|
||||||
|
proxy_http_version 1.1;
|
||||||
|
proxy_set_header Host $host;
|
||||||
|
add_header Cache-Control "public, max-age=31536000, immutable";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
NGINX_CONF
|
||||||
|
|
||||||
|
# 测试并重载
|
||||||
|
nginx -t && systemctl reload nginx
|
||||||
|
log_success "Nginx HTTPS 配置完成"
|
||||||
|
}
|
||||||
|
|
||||||
|
# 配置证书自动续期
|
||||||
|
setup_auto_renewal() {
|
||||||
|
log_info "配置证书自动续期..."
|
||||||
|
|
||||||
|
# Certbot 会自动创建 systemd timer 或 cron job
|
||||||
|
# 测试续期
|
||||||
|
certbot renew --dry-run
|
||||||
|
|
||||||
|
log_success "证书自动续期已配置"
|
||||||
|
}
|
||||||
|
|
||||||
|
# 配置防火墙
|
||||||
|
configure_firewall() {
|
||||||
|
log_info "配置防火墙..."
|
||||||
|
|
||||||
|
if command -v ufw &> /dev/null; then
|
||||||
|
ufw allow 'Nginx Full'
|
||||||
|
ufw allow OpenSSH
|
||||||
|
ufw --force enable
|
||||||
|
log_success "UFW 防火墙已配置"
|
||||||
|
else
|
||||||
|
log_warn "未检测到 UFW，请手动配置防火墙开放 80 和 443 端口"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# 显示完成信息
|
||||||
|
show_completion() {
|
||||||
|
echo ""
|
||||||
|
echo -e "${GREEN}========================================${NC}"
|
||||||
|
echo -e "${GREEN} 安装完成!${NC}"
|
||||||
|
echo -e "${GREEN}========================================${NC}"
|
||||||
|
echo ""
|
||||||
|
echo -e "访问地址: ${BLUE}https://$DOMAIN${NC}"
|
||||||
|
echo ""
|
||||||
|
echo "常用命令:"
|
||||||
|
echo " 查看 Nginx 状态: systemctl status nginx"
|
||||||
|
echo " 重载 Nginx: systemctl reload nginx"
|
||||||
|
echo " 查看证书: certbot certificates"
|
||||||
|
echo " 手动续期: certbot renew"
|
||||||
|
echo " 查看日志: tail -f /var/log/nginx/$DOMAIN.access.log"
|
||||||
|
echo ""
|
||||||
|
}
|
||||||
|
|
||||||
|
# 主函数
|
||||||
|
main() {
|
||||||
|
echo ""
|
||||||
|
echo "============================================"
|
||||||
|
echo " RWADurian Admin Web - Nginx 安装脚本"
|
||||||
|
echo " 域名: $DOMAIN"
|
||||||
|
echo "============================================"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
check_root
|
||||||
|
update_system
|
||||||
|
install_nginx
|
||||||
|
install_certbot
|
||||||
|
configure_firewall
|
||||||
|
configure_nginx_http
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
log_warn "请确保以下条件已满足:"
|
||||||
|
echo " 1. 域名 $DOMAIN 的 DNS A 记录已指向本服务器 IP"
|
||||||
|
echo " 2. Docker 应用已在端口 $APP_PORT 运行"
|
||||||
|
echo ""
|
||||||
|
read -p "是否继续申请 SSL 证书? (y/n): " confirm
|
||||||
|
|
||||||
|
if [ "$confirm" = "y" ] || [ "$confirm" = "Y" ]; then
|
||||||
|
obtain_ssl_certificate
|
||||||
|
configure_nginx_https
|
||||||
|
setup_auto_renewal
|
||||||
|
show_completion
|
||||||
|
else
|
||||||
|
log_info "已跳过 SSL 配置，当前为 HTTP 模式"
|
||||||
|
log_info "稍后可运行: certbot --nginx -d $DOMAIN"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
main "$@"
|
||||||
Loading…
Reference in New Issue