10 KiB
10 KiB
TGOIM 公司官网部署文档
域名:www.tgoim.com
服务器:阿里云 ECS Ubuntu 24.04
Web 服务器:Nginx(已安装,已部署过其他 HTTPS 站点)
HTTPS 证书:Let's Encrypt(certbot)
一、部署前准备
1.1 本地准备工作
# 在本地项目根目录 (d:\Git\company_website) 执行
# 1. 更新 requirements.txt,确保包含生产环境需要的依赖
# (已有 Django + Pillow,生产环境还需要 gunicorn)
# 2. 创建生产环境配置文件
1.2 服务器信息确认
在服务器上执行以下命令确认环境:
# 确认操作系统
lsb_release -a
# 确认 Nginx 已安装且运行
nginx -v
sudo systemctl status nginx
# 确认 Python 3 版本
python3 --version
# 确认 certbot 是否已安装(如果之前用过)
certbot --version
# 确认是否已安装 python3-venv 和 python3-pip
python3 -m venv --help
pip3 --version
1.3 域名解析确认
在阿里云控制台 → 云解析 DNS 中确认:
www.tgoim.com的 A 记录已解析到 ECS 公网 IPtgoim.com(裸域名)也建议解析到同一 IP
二、服务器环境安装
2.1 安装必要依赖
# 更新系统
sudo apt update && sudo apt upgrade -y
# 安装 Python 虚拟环境和 pip(如果未安装)
sudo apt install -y python3 python3-pip python3-venv python3-dev
# 安装 Supervisor(进程守护)
sudo apt install -y supervisor
# 安装 certbot(如果未安装)
sudo apt install -y certbot python3-certbot-nginx
三、代码上传
3.1 方式一:使用 Git 拉取(推荐)
# 在服务器上创建项目目录
cd /opt
sudo mkdir company_website
sudo chown -R $USER:$USER /opt/company_website
# 克隆代码(替换为你的 Git 仓库地址)
cd /opt/company_website
git clone <你的仓库地址> .
# 如果代码不在 Git 上,使用方式二
3.2 方式二:使用 SCP 上传(本地 Windows)
在本地 PowerShell 中执行:
# 先打包(排除虚拟环境和数据库)
cd d:\Git\company_website
tar -czf tgoim_deploy.tar.gz --exclude='.venv' --exclude='db.sqlite3' --exclude='__pycache__' --exclude='*.pyc' --exclude='staticfiles' --exclude='media' .
# 上传到服务器(替换 user 和 server_ip)
scp tgoim_deploy.tar.gz user@server_ip:/tmp/
然后在服务器上解压:
cd /opt
sudo mkdir company_website
sudo chown -R $USER:$USER /opt/company_website
cd /opt/company_website
tar -xzf /tmp/tgoim_deploy.tar.gz
四、项目配置
4.1 创建虚拟环境并安装依赖
cd /opt/company_website
# 创建虚拟环境
python3 -m venv venv
# 激活并安装依赖
source venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt
pip install gunicorn
4.2 配置生产环境变量
cd /opt/company_website
# 创建 .env 文件
cat > .env << 'EOF'
DJANGO_SECRET_KEY=$(python3 -c "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())")
DJANGO_DEBUG=False
DJANGO_ALLOWED_HOSTS=www.tgoim.com,tgoim.com,127.0.0.1,localhost
EOF
# 验证
cat .env
4.3 数据库迁移和静态文件收集
cd /opt/company_website
source venv/bin/activate
# 数据库迁移(使用 SQLite,直接创建)
python manage.py migrate
# 收集静态文件
python manage.py collectstatic --noinput
# 创建超级管理员
python manage.py createsuperuser
4.4 设置文件权限
cd /opt/company_website
# 创建媒体目录
mkdir -p media
# 项目根目录需要可写(SQLite 需要在目录中创建 journal/wal 临时文件)
sudo chown www-data:www-data .
# 数据库文件需要可写
sudo chown www-data:www-data db.sqlite3
# 媒体目录需要可写(用于上传文件)
sudo chown -R www-data:www-data media
# 其他文件和目录设置为只读(除了上面已设置的)
sudo find . -path ./media -prune -o \
-name db.sqlite3 -prune -o \
-type d -exec chmod 755 {} \; -o \
-type f -exec chmod 644 {} \;
五、Gunicorn 配置
5.1 创建 Gunicorn 配置文件
cd /opt/company_website
cat > gunicorn_config.py << 'EOF'
import multiprocessing
bind = "127.0.0.1:38000"
workers = multiprocessing.cpu_count() * 2 + 1
worker_class = "sync"
worker_connections = 1000
max_requests = 5000
timeout = 30
keepalive = 5
preload_app = True
daemon = False
accesslog = "/var/log/gunicorn/tgoim_access.log"
errorlog = "/var/log/gunicorn/tgoim_error.log"
loglevel = "info"
EOF
5.2 创建日志目录
sudo mkdir -p /var/log/gunicorn
sudo chown -R www-data:www-data /var/log/gunicorn
六、Supervisor 配置
6.1 创建 Supervisor 配置
sudo cat > /etc/supervisor/conf.d/tgoim.conf << 'EOF'
[program:tgoim]
command=/opt/company_website/venv/bin/gunicorn company_website.wsgi:application -c /opt/company_website/gunicorn_config.py
directory=/opt/company_website
user=www-data
autostart=true
autorestart=true
startsecs=10
stopwaitsecs=30
stdout_logfile=/var/log/supervisor/tgoim_stdout.log
stderr_logfile=/var/log/supervisor/tgoim_stderr.log
environment=DJANGO_SETTINGS_MODULE="company_website.settings"
EOF
6.2 启动并验证
# 重新加载 Supervisor 配置
sudo supervisorctl reread
sudo supervisorctl update
# 启动服务
sudo supervisorctl start tgoim
# 查看状态
sudo supervisorctl status tgoim
# 如果显示 RUNNING 则正常
如果启动失败,查看日志排查:
sudo tail -30 /var/log/supervisor/tgoim_stderr.log
sudo tail -30 /var/log/gunicorn/tgoim_error.log
七、Nginx 配置
7.1 创建 Nginx 站点配置
由于服务器上已有其他 HTTPS 站点,先创建一个 HTTP 的配置,申请证书后再升级为 HTTPS。
sudo cat > /etc/nginx/sites-available/tgoim.com << 'EOF'
# HTTP 配置(用于申请证书,后续 certbot 会自动升级为 HTTPS)
server {
listen 80;
server_name www.tgoim.com tgoim.com;
root /opt/company_website;
# 日志
access_log /var/log/nginx/tgoim_access.log;
error_log /var/log/nginx/tgoim_error.log;
# 允许上传的最大文件大小(产品图片、视频等)
client_max_body_size 50M;
# Gzip 压缩
gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_types text/plain text/css text/xml text/javascript application/json application/javascript application/xml+rss application/xml font/truetype font/opentype application/vnd.ms-fontobject image/svg+xml;
# 静态文件直接由 Nginx 处理
location /static/ {
alias /opt/company_website/staticfiles/;
expires 30d;
add_header Cache-Control "public, immutable";
}
location /media/ {
alias /opt/company_website/media/;
expires 7d;
add_header Cache-Control "public";
}
# Django 动态请求转发到 Gunicorn
location / {
proxy_pass http://127.0.0.1:38000;
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_connect_timeout 300;
proxy_read_timeout 300;
}
}
EOF
7.2 启用站点
# 建立软链接启用站点
sudo ln -sf /etc/nginx/sites-available/tgoim.com /etc/nginx/sites-enabled/
# 检查 Nginx 配置
sudo nginx -t
# 如果显示 syntax is ok 则重启 Nginx
sudo systemctl reload nginx
八、申请 Let's Encrypt HTTPS 证书
8.1 使用 certbot 自动申请和配置
由于服务器已部署过其他 HTTPS 站点,certbot 应该已有安装。直接执行:
# 申请证书并自动配置 Nginx(certbot 会自动修改配置)
sudo certbot --nginx -d www.tgoim.com -d tgoim.com
执行过程中会提示:
- 输入邮箱(用于接收证书过期提醒)
- 同意服务条款(输入 Y)
- 是否接收 EFF 邮件(选 Y 或 N 均可)
- 是否强制 HTTPS 重定向(选 2: Redirect)
8.2 验证证书
# 检查证书是否申请成功
sudo ls -la /etc/letsencrypt/live/tgoim.com/
# 查看 Nginx 配置,certbot 应该已自动修改
sudo cat /etc/nginx/sites-available/tgoim.com
正常情况下 certbot 会自动在配置中添加:
listen 443 ssl http2;- SSL 证书路径
- HTTP 到 HTTPS 的 301 重定向
8.3 证书自动续期
Let's Encrypt 证书有效期 90 天,certbot 会自动设置定时器续期。验证:
# 检查续期定时器
sudo systemctl list-timers | grep certbot
# 测试续期(不会真的续期,只检查流程)
sudo certbot renew --dry-run
九、验证部署
9.1 本地测试(跳过 DNS)
在服务器本地测试:
curl -I http://127.0.0.1:38000/
curl -I http://127.0.0.1/ --header "Host: www.tgoim.com"
9.2 外网测试
浏览器访问:
- http://www.tgoim.com → 应该自动跳转到 https://www.tgoim.com
- https://www.tgoim.com → 应该正常显示网站
- https://www.tgoim.com/admin/ → 后台登录页
9.3 检查清单
- 首页正常显示
- 各栏目页面可访问
- 多语言切换正常(中文/英文)
- 后台管理可登录
- 图片和静态资源加载正常
- HTTP 自动跳转到 HTTPS
- 浏览器地址栏显示锁图标(安全连接)
十、后续维护
10.1 更新代码
cd /opt/company_website
# 拉取最新代码
git pull origin main
# 激活虚拟环境
source venv/bin/activate
# 安装新依赖(如有)
pip install -r requirements.txt
# 数据库迁移
python manage.py migrate
# 收集静态文件
python manage.py collectstatic --noinput
# 重启服务
sudo supervisorctl restart tgoim
10.2 常用命令
# 查看服务状态
sudo supervisorctl status tgoim
# 重启服务
sudo supervisorctl restart tgoim
# 停止服务
sudo supervisorctl stop tgoim
# 查看 Gunicorn 日志
sudo tail -f /var/log/gunicorn/tgoim_error.log
# 查看 Nginx 日志
sudo tail -f /var/log/nginx/tgoim_access.log
# 测试 Nginx 配置
sudo nginx -t
# 重载 Nginx
sudo systemctl reload nginx
10.3 备份
# 备份数据库和媒体文件
cd /opt/company_website
tar -czf /tmp/tgoim_backup_$(date +%Y%m%d).tar.gz db.sqlite3 media/
# 下载到本地(从本地执行)
scp user@server_ip:/tmp/tgoim_backup_xxx.tar.gz .
部署文档结束