# TGOIM 公司官网部署文档 **域名**:www.tgoim.com **服务器**:阿里云 ECS Ubuntu 24.04 **Web 服务器**:Nginx(已安装,已部署过其他 HTTPS 站点) **HTTPS 证书**:Let's Encrypt(certbot) --- ## 一、部署前准备 ### 1.1 本地准备工作 ```bash # 在本地项目根目录 (d:\Git\company_website) 执行 # 1. 更新 requirements.txt,确保包含生产环境需要的依赖 # (已有 Django + Pillow,生产环境还需要 gunicorn) # 2. 创建生产环境配置文件 ``` ### 1.2 服务器信息确认 在服务器上执行以下命令确认环境: ```bash # 确认操作系统 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 公网 IP - `tgoim.com`(裸域名)也建议解析到同一 IP --- ## 二、服务器环境安装 ### 2.1 安装必要依赖 ```bash # 更新系统 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 拉取(推荐) ```bash # 在服务器上创建项目目录 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 中执行: ```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/ ``` 然后在服务器上解压: ```bash 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 创建虚拟环境并安装依赖 ```bash 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 配置生产环境变量 ```bash 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 数据库迁移和静态文件收集 ```bash cd /opt/company_website source venv/bin/activate # 数据库迁移(使用 SQLite,直接创建) python manage.py migrate # 收集静态文件 python manage.py collectstatic --noinput # 创建超级管理员 python manage.py createsuperuser ``` ### 4.4 设置文件权限 ```bash 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 配置文件 ```bash 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 创建日志目录 ```bash sudo mkdir -p /var/log/gunicorn sudo chown -R www-data:www-data /var/log/gunicorn ``` --- ## 六、Supervisor 配置 ### 6.1 创建 Supervisor 配置 ```bash 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 启动并验证 ```bash # 重新加载 Supervisor 配置 sudo supervisorctl reread sudo supervisorctl update # 启动服务 sudo supervisorctl start tgoim # 查看状态 sudo supervisorctl status tgoim # 如果显示 RUNNING 则正常 ``` 如果启动失败,查看日志排查: ```bash 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。 ```bash 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; # 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 启用站点 ```bash # 建立软链接启用站点 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 应该已有安装。直接执行: ```bash # 申请证书并自动配置 Nginx(certbot 会自动修改配置) sudo certbot --nginx -d www.tgoim.com -d tgoim.com ``` 执行过程中会提示: 1. 输入邮箱(用于接收证书过期提醒) 2. 同意服务条款(输入 Y) 3. 是否接收 EFF 邮件(选 Y 或 N 均可) 4. 是否强制 HTTPS 重定向(选 2: Redirect) ### 8.2 验证证书 ```bash # 检查证书是否申请成功 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 会自动设置定时器续期。验证: ```bash # 检查续期定时器 sudo systemctl list-timers | grep certbot # 测试续期(不会真的续期,只检查流程) sudo certbot renew --dry-run ``` --- ## 九、验证部署 ### 9.1 本地测试(跳过 DNS) 在服务器本地测试: ```bash 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 更新代码 ```bash 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 常用命令 ```bash # 查看服务状态 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 备份 ```bash # 备份数据库和媒体文件 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 . ``` --- *部署文档结束*