Skip to content

域名配置指南 ​

域名信息 ​

当前域名: bjbmkj.cn

域名解析 ​

1. 添加A记录 ​

登录域名服务商控制台,添加以下DNS记录:

类型: A
主机记录: @
记录值: 8.147.129.77
TTL: 600

2. 添加www子域名 ​

类型: CNAME
主机记录: www
记录值: bjbmkj.cn
TTL: 600

3. 添加docs子域名(文档站点) ​

类型: A
主机记录: docs
记录值: 8.147.129.77
TTL: 600

4. 验证解析 ​

bash
# 检查域名解析
ping bjbmkj.cn
ping www.bjbmkj.cn
ping docs.bjbmkj.cn

# 使用dig命令
dig bjbmkj.cn
dig docs.bjbmkj.cn

Nginx配置 ​

主站点配置 ​

文件位置: /etc/nginx/conf.d/bjbmkj.conf

nginx
# HTTP服务器
server {
    listen 80;
    server_name bjbmkj.cn www.bjbmkj.cn;

    # 重定向到HTTPS
    return 301 https://$server_name$request_uri;
}

# HTTPS服务器
server {
    listen 443 ssl http2;
    server_name bjbmkj.cn www.bjbmkj.cn;

    # SSL证书配置
    ssl_certificate /etc/letsencrypt/live/bjbmkj.cn/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/bjbmkj.cn/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;

    # API反向代理
    location /api/ {
        proxy_pass http://127.0.0.1:3003/api/;
        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;
    }

    # WebSocket支持
    location /socket.io/ {
        proxy_pass http://127.0.0.1:3003/socket.io/;
        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;
    }

    # 文件上传
    location /uploads/ {
        alias /var/www/src/uploads/;
        expires 30d;
        access_log off;
        add_header Cache-Control "public, immutable";
    }

    # 根路径 - 显示欢迎页面或重定向到文档
    location / {
        return 301 https://docs.bjbmkj.cn;
    }

    # Gzip压缩
    gzip on;
    gzip_vary on;
    gzip_proxied any;
    gzip_comp_level 6;
    gzip_types text/plain text/css text/xml text/javascript application/json application/javascript application/xml+rss;

    # 安全头
    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 "no-referrer-when-downgrade" always;
}

文档站点配置 ​

文件位置: /etc/nginx/conf.d/docs.bjbmkj.conf

nginx
# HTTP服务器
server {
    listen 80;
    server_name docs.bjbmkj.cn;

    # 重定向到HTTPS
    return 301 https://$server_name$request_uri;
}

# HTTPS服务器
server {
    listen 443 ssl http2;
    server_name docs.bjbmkj.cn;

    # SSL证书配置
    ssl_certificate /etc/letsencrypt/live/bjbmkj.cn/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/bjbmkj.cn/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;

    # 文档站点根目录
    root /opt/apps/docs-site/dist;
    index index.html;

    # SPA路由支持
    location / {
        try_files $uri $uri/ /index.html;
    }

    # 静态资源缓存
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
        expires 1y;
        access_log off;
        add_header Cache-Control "public, immutable";
    }

    # Gzip压缩
    gzip on;
    gzip_vary on;
    gzip_proxied any;
    gzip_comp_level 6;
    gzip_types text/plain text/css text/xml text/javascript application/json application/javascript application/xml+rss 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;
}

SSL证书配置 ​

使用Let's Encrypt ​

1. 安装Certbot ​

bash
# CentOS
yum install certbot python3-certbot-nginx -y

# Ubuntu
apt install certbot python3-certbot-nginx -y

2. 获取证书 ​

bash
# 为主域名和所有子域名获取证书
certbot --nginx -d bjbmkj.cn -d www.bjbmkj.cn -d docs.bjbmkj.cn

# 按提示输入邮箱和同意协议

3. 自动续期 ​

Let's Encrypt证书有效期90天,需要定期续期:

bash
# 测试续期
certbot renew --dry-run

# 设置自动续期cron任务
crontab -e

# 添加以下行(每天凌晨2点检查)
0 2 * * * certbot renew --quiet --post-hook "systemctl reload nginx"

4. 查看证书信息 ​

bash
# 查看证书列表
certbot certificates

# 查看证书详情
openssl x509 -in /etc/letsencrypt/live/bjbmkj.cn/cert.pem -text -noout

测试配置 ​

1. 测试Nginx配置 ​

bash
# 检查配置文件语法
nginx -t

# 重新加载配置
systemctl reload nginx

# 重启Nginx
systemctl restart nginx

2. 测试域名访问 ​

bash
# 测试HTTP (应该重定向到HTTPS)
curl -I http://bjbmkj.cn

# 测试HTTPS
curl -I https://bjbmkj.cn

# 测试API
curl https://bjbmkj.cn/api/health

# 测试文档站点
curl -I https://docs.bjbmkj.cn

3. 测试SSL证书 ​

在线工具:

命令行测试:

bash
openssl s_client -connect bjbmkj.cn:443 -servername bjbmkj.cn

防火墙配置 ​

CentOS 7 (firewalld) ​

bash
# 开放HTTP端口
firewall-cmd --permanent --add-service=http

# 开放HTTPS端口
firewall-cmd --permanent --add-service=https

# 重新加载防火墙
firewall-cmd --reload

# 查看开放的端口
firewall-cmd --list-all

Ubuntu (ufw) ​

bash
# 允许HTTP
ufw allow 80/tcp

# 允许HTTPS
ufw allow 443/tcp

# 启用防火墙
ufw enable

# 查看状态
ufw status

阿里云安全组 ​

登录阿里云控制台,添加安全组规则:

入方向规则:
- 协议: TCP
- 端口: 80
- 源: 0.0.0.0/0
- 描述: HTTP

- 协议: TCP
- 端口: 443
- 源: 0.0.0.0/0
- 描述: HTTPS

性能优化 ​

1. 启用HTTP/2 ​

HTTP/2已在上述Nginx配置中启用(http2参数)。

验证:

bash
curl -I --http2 https://bjbmkj.cn

2. 启用Brotli压缩 (可选) ​

比Gzip更高效的压缩算法:

bash
# 安装Brotli模块
yum install nginx-module-brotli -y

# 在nginx.conf中加载模块
load_module modules/ngx_http_brotli_filter_module.so;
load_module modules/ngx_http_brotli_static_module.so;

# 在server块中启用
brotli on;
brotli_comp_level 6;
brotli_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;

3. CDN加速 (可选) ​

使用阿里云CDN或Cloudflare加速静态资源:

  1. 创建CDN域名: cdn.bjbmkj.cn
  2. 配置源站: docs.bjbmkj.cn
  3. 缓存规则:
    • HTML: 不缓存或缓存1小时
    • CSS/JS: 缓存1年
    • 图片: 缓存1年

监控和日志 ​

访问日志 ​

nginx
# 自定义日志格式
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
                '$status $body_bytes_sent "$http_referer" '
                '"$http_user_agent" "$http_x_forwarded_for"';

# 主站点日志
access_log /var/log/nginx/bjbmkj_access.log main;
error_log /var/log/nginx/bjbmkj_error.log warn;

# 文档站点日志
access_log /var/log/nginx/docs_access.log main;
error_log /var/log/nginx/docs_error.log warn;

日志分析 ​

bash
# 查看访问量
cat /var/log/nginx/bjbmkj_access.log | wc -l

# 查看访问IP
awk '{print $1}' /var/log/nginx/bjbmkj_access.log | sort | uniq -c | sort -rn | head -20

# 查看最多访问的URL
awk '{print $7}' /var/log/nginx/bjbmkj_access.log | sort | uniq -c | sort -rn | head -20

# 查看错误日志
tail -f /var/log/nginx/bjbmkj_error.log

日志轮转 ​

创建 /etc/logrotate.d/nginx:

/var/log/nginx/*.log {
    daily
    rotate 14
    compress
    delaycompress
    missingok
    notifempty
    create 0640 nginx adm
    sharedscripts
    postrotate
        if [ -f /var/run/nginx.pid ]; then
            kill -USR1 `cat /var/run/nginx.pid`
        fi
    endscript
}

故障排查 ​

域名无法访问 ​

  1. 检查DNS解析
bash
nslookup bjbmkj.cn
  1. 检查Nginx状态
bash
systemctl status nginx
  1. 检查防火墙
bash
firewall-cmd --list-all
  1. 查看错误日志
bash
tail -100 /var/log/nginx/error.log

SSL证书问题 ​

  1. 检查证书是否过期
bash
certbot certificates
  1. 手动续期
bash
certbot renew
systemctl reload nginx
  1. 强制更新证书
bash
certbot renew --force-renewal

性能问题 ​

  1. 检查Nginx工作进程数
nginx
worker_processes auto;
  1. 调整连接数
nginx
events {
    worker_connections 2048;
}
  1. 启用缓存
nginx
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=api_cache:10m max_size=1g inactive=60m;

location /api/ {
    proxy_cache api_cache;
    proxy_cache_valid 200 10m;
    proxy_cache_use_stale error timeout http_500 http_502 http_503 http_504;
}

域名迁移 ​

如果需要更换域名:

  1. 添加新域名DNS解析
  2. 更新Nginx配置
  3. 获取新域名SSL证书
  4. 设置301重定向从旧域名到新域名
  5. 更新Android应用配置
  6. 发布新版本APK

参考资料 ​

炳明一企通正式版 · 企业服务与协同管理