nginx-proxy-automation升级与迁移指南：平滑过渡到新版本

nginx-proxy-automation升级与迁移指南：平滑过渡到新版本

【免费下载链接】nginx-proxy-automationAutomated docker nginx proxy integrated with letsencrypt.项目地址: https://gitcode.com/gh_mirrors/ng/nginx-proxy-automation

nginx-proxy-automation是一款集成Let's Encrypt的自动化Docker Nginx代理工具，本指南将帮助你安全高效地完成版本升级与迁移，确保服务平滑过渡到新版本。

🌟 为什么需要升级？

新版本通常包含重要的安全更新、功能增强和性能优化。以v0.5版本为例，它带来了更强大的自动化能力，让证书管理和代理配置变得更加智能。定期升级可以确保你的服务始终运行在最佳状态，同时避免潜在的安全风险。

📋 升级前准备工作

环境检查

在开始升级前，请确保你的系统满足以下要求：

• 操作系统：Linux
• 必备软件：Bash、Docker、Docker Compose、Git、Curl等

完整的软件需求清单可以查看docs/requirements.md文件。

数据备份

升级前最重要的步骤是备份所有数据：

1. 备份当前项目目录下的所有文件
2. 特别注意保存docker-compose.yml和.env配置文件
3. 建议将备份文件存储在服务器以外的安全位置

🚀 升级步骤详解

1. 保存当前配置

首先，复制当前的配置文件，以便在需要时回滚：

$ cp docker-compose.yml docker-compose-old.yml $ cp .env .env-old

2. 获取最新代码

更新Git仓库到最新版本：

$ git reset --hard $ git pull origin master $ git checkout master

3. 初始化子模块

项目使用了basescript子模块，需要初始化并更新：

$ git submodule init $ git submodule update

4. 运行初始化脚本

进入bin目录并运行fresh-start.sh脚本：

$ cd bin $ ./fresh-start.sh

运行过程中可能会出现端口绑定错误，这是正常现象，因为当前Nginx代理容器正在使用80端口。

5. 网络配置调整

如果新版本创建了新的网络，需要将所有运行中的容器连接到新网络：

$ docker network connect [YOUR_NEW_NETWORK_NAME] [CONTAINER_NAME]

记得更新所有站点的docker-compose文件中的网络名称。

6. 切换到新版本

停止旧版本并启动新版本，以减少 downtime：

$ docker-compose --file docker-compose-old.yml down && docker-compose up -d

7. 验证与测试

升级完成后，访问你的网站检查是否正常运行。可以查看Let's Encrypt容器日志，确保证书正确生成：

$ docker logs [letsencrypt_container_name]

⏪ 回滚方案

如果升级过程中出现问题，可以快速回滚到旧版本：

$ docker-compose down && docker-compose --file docker-compose-old.yml --env-file .env-old up -d

🧹 升级后清理

确认新版本运行正常后，可以删除备份文件：

$ rm docker-compose-old.yml .env-old

📚 更多资源

• 完整升级指南：docs/upgrade-guide.md
• 项目官方文档：docs/README.md

通过以上步骤，你可以顺利完成nginx-proxy-automation的升级与迁移。如果遇到任何问题，建议查看项目文档或相关社区讨论获取帮助。定期升级是保持服务安全和高效运行的关键，希望本指南能帮助你轻松应对版本更新。

【免费下载链接】nginx-proxy-automationAutomated docker nginx proxy integrated with letsencrypt.项目地址: https://gitcode.com/gh_mirrors/ng/nginx-proxy-automation