eeacms/maintenance-service
eeacms
提供R3系统维护模式网页的服务，用于在系统维护期间向用户展示维护状态页面，告知系统暂时不可用及相关维护信息。
下载次数: 0状态：社区镜像维护者：eeacms仓库类型：镜像最近更新：10 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
R3维护模式网页服务镜像
镜像概述
R3维护模式网页服务镜像是一个轻量级服务，用于在R3系统进行维护、升级或故障恢复期间，临时提供维护模式静态网页。该服务可替代正常业务服务，向用户展示系统维护状态，包括维护原因、预计恢复时间等信息，提升用户体验并减少无效访问。
核心功能和特性
- 预定义R3维护页面：内置符合R3系统风格的维护模式静态页面，包含标准维护提示元素
- 自定义维护信息：支持通过配置自定义维护标题、描述文本及预计恢复时间
- 轻量级部署：基于Nginx轻量服务器构建，资源占用低，启动速度快
- 灵活配置：支持环境变量配置或挂载自定义页面文件，满足个性化需求
- 跨平台兼容：可在Docker支持的任何环境中运行，包括物理机、虚拟机及容器编排平台
使用场景和适用范围
适用场景
- R3系统计划内维护（如版本升级、数据迁移）期间的用户引导
- R3服务集群故障恢复期间的临时页面展示
- R3相关Web应用临时下线时的用户告知
- 避免用户访问不稳定或不可用的R3系统实例
适用范围
- R3系统相关的Web应用服务
- 基于容器化部署的R3服务集群
- 需要向用户清晰传达维护状态的IT运维场景
使用方法和配置说明
基本部署（Docker Run）
通过以下命令快速启动维护模式服务：
bashdocker run -d \ --name r3-maintenance \ -p 80:80 \ r3-maintenance-service:latest
启动后，访问http://localhost即可看到默认维护页面。
自定义维护信息（环境变量配置）
通过环境变量自定义维护页面内容：
bashdocker run -d \ --name r3-maintenance \ -p 80:80 \ -e MAINTENANCE_TITLE="R3系统升级维护" \ -e MAINTENANCE_DESC="系统正在进行版本升级，预计2小时后恢复正常访问" \ -e RECOVERY_TIME="2024-12-31 18:00" \ r3-maintenance-service:latest
挂载自定义页面（高级配置）
如需完全自定义页面样式，可挂载本地HTML文件：
bashdocker run -d \ --name r3-maintenance \ -p 80:80 \ -v /path/to/custom/index.html:/usr/share/nginx/html/index.html \ r3-maintenance-service:latest
Docker Compose配置
在docker-compose.yml中集成：
yamlversion: '3' services: maintenance: image: r3-maintenance-service:latest ports: - "80:80" environment: - MAINTENANCE_TITLE="R3系统例行维护" - MAINTENANCE_DESC="每周三凌晨2:00-4:00进行系统例行维护，期间服务暂停" - RECOVERY_TIME="2024-12-31 04:00" restart: unless-stopped
配置参数说明
| 参数名 | 描述 | 默认值 |
|---|---|---|
| MAINTENANCE_TITLE | 维护页面标题 | "系统维护中" |
| MAINTENANCE_DESC | 维护描述信息 | "系统正在维护，暂时无法提供服务" |
| RECOVERY_TIME | 预计恢复时间 | "待定" |
| PORT | 服务监听端口 | 80 |
| LANGUAGE | 页面语言（zh/en） | zh |
自定义页面开发指南
如需完全自定义页面样式，可创建符合以下结构的HTML文件并挂载：
html<!DOCTYPE html> <html> <head> <title>R3系统维护</title> <link rel="stylesheet" href="/css/main.css"> <!-- 可引用容器内默认CSS --> </head> <body> <div class="maintenance-container"> <h1>自定义维护标题</h1> <p>自定义维护描述信息</p> <p>预计恢复时间：2024-12-31 18:00</p> </div> </body> </html>
将文件保存为index.html，通过-v参数挂载至容器/usr/share/nginx/html/目录即可生效。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 maintenance-service 镜像标签
docker pull docker.xuanyuan.run/eeacms/maintenance-service:<标签>
DockerHub 原生拉取命令
docker pull eeacms/maintenance-service:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"