482 lines
10 KiB
Markdown
482 lines
10 KiB
Markdown
# 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;
|
||
|
||
# 允许上传的最大文件大小(产品图片、视频等)
|
||
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 启用站点
|
||
|
||
```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 .
|
||
```
|
||
|
||
---
|
||
|
||
*部署文档结束*
|