vue-driven-cloud-storage/INSTALL_SH_UPDATE.md

install.sh 更新说明 - 验证码Cookie配置

需要修改的原因

验证码功能依赖Cookie传递session信息。install.sh生成的Nginx配置中缺少Cookie传递设置，导致验证码无法正常工作。

需要修改的位置

install.sh文件中有3处location /api配置需要添加Cookie传递设置。

位置1：第2372-2387行（HTTP配置）

在 configure_nginx_http_first() 函数中：

location /api {
    proxy_pass http://localhost:${BACKEND_PORT};
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;
    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;

    # ⬇️ 在这里添加以下3行 ⬇️
    # Cookie传递配置（验证码session需要）
    proxy_set_header Cookie $http_cookie;
    proxy_pass_header Set-Cookie;

    # 上传超时设置
    proxy_read_timeout 3600s;
    proxy_send_timeout 3600s;
    proxy_connect_timeout 300s;
}

位置2：第2650行附近（HTTPS配置）

在 configure_nginx_final() 函数的HTTPS配置中：

location /api {
    proxy_pass http://localhost:${BACKEND_PORT};
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;
    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;

    # ⬇️ 在这里添加以下3行 ⬇️
    # Cookie传递配置（验证码session需要）
    proxy_set_header Cookie $http_cookie;
    proxy_pass_header Set-Cookie;

    # 上传超时设置
    proxy_read_timeout 3600s;
    proxy_send_timeout 3600s;
    proxy_connect_timeout 300s;
}

位置3：第2783行附近（虚拟主机配置）

在另一个Nginx配置块中：

location /api {
    proxy_pass http://localhost:${BACKEND_PORT};
    # ... 其他配置 ...
    proxy_set_header X-Forwarded-Proto $scheme;

    # ⬇️ 在这里添加以下3行 ⬇️
    # Cookie传递配置（验证码session需要）
    proxy_set_header Cookie $http_cookie;
    proxy_pass_header Set-Cookie;

    # 上传超时设置
    # ...
}

手动修改方法

方法1：使用vim编辑器

vim install.sh

# 在vim中：
# 1. 按 / 搜索：location /api
# 2. 找到 proxy_set_header X-Forwarded-Proto $scheme; 这一行
# 3. 在其后添加3行Cookie配置
# 4. 按 n 继续查找下一个，重复步骤2-3
# 5. 共修改3处
# 6. :wq 保存退出

方法2：使用sed批量替换

cd /home/yuyx/aaaaaa/网盘/vue-driven-cloud-storage

# 备份
cp install.sh install.sh.backup

# 批量替换（在所有location /api块中的X-Forwarded-Proto后添加）
# 注意：这个命令需要仔细测试
sed -i '/proxy_set_header X-Forwarded-Proto \\$scheme;/a\
\
        # Cookie传递配置（验证码session需要）\
        proxy_set_header Cookie $http_cookie;\
        proxy_pass_header Set-Cookie;' install.sh

# 验证修改
grep -A 2 "Cookie传递配置" install.sh

方法3：手动复制粘贴

1. 打开install.sh
2. 搜索 location /api（会找到3处）
3. 在每处的 proxy_set_header X-Forwarded-Proto $scheme; 后面添加：

        # Cookie传递配置（验证码session需要）
        proxy_set_header Cookie $http_cookie;
        proxy_pass_header Set-Cookie;

验证修改

# 检查是否修改了3处
grep -c "Cookie传递配置" install.sh
# 输出应该是: 3

# 查看修改的位置
grep -n "Cookie传递配置" install.sh

应用修改

新部署时

直接运行修改后的install.sh即可，它会生成包含Cookie配置的Nginx配置文件。

已部署的服务

需要手动更新Nginx配置文件：

# 编辑Nginx配置
vim /etc/nginx/sites-available/玩玩云.conf
# 或
vim /etc/nginx/conf.d/玩玩云.conf

# 在location /api块中添加Cookie配置
# 测试配置
nginx -t

# 重新加载
nginx -s reload

为什么需要这个配置

1. proxy_set_header Cookie $http_cookie;

   • 将浏览器发送的Cookie转发给后端
   • 后端才能读取验证码session

2. proxy_pass_header Set-Cookie;

   • 将后端的Set-Cookie响应头传递给浏览器
   • 浏览器才能保存验证码session cookie

3. 缺少这两行会导致：

   • 验证码session无法建立
   • 验证码一直提示"已过期"
   • Cookie在Nginx层被过滤掉

相关提交

• nginx/nginx.conf 已经修改（提交 5f3fd38）
• install.sh 需要同步更新（本文档）

注意事项

• 修改install.sh后，需要提交到Git
• 已部署的服务需要手动更新Nginx配置
• 修改后记得测试验证码功能