PolyHermes/deploy-interactive-README.md

PolyHermes One-Click Deployment Script / PolyHermes 一键部署脚本使用说明

English | 中文

---

English

✨ Core Features

• Run from any directory - No need to download source code
• Online images only - Pull official images from Docker Hub
• Auto-download config - Download the latest docker-compose.prod.yml from GitHub
• Interactive configuration - User-friendly Q&A style configuration wizard
• Auto-generate secrets - All sensitive configurations will auto-generate secure random values on Enter

🚀 Quick Start

One-Click Installation (Recommended)

Using curl (Recommended):

mkdir -p ~/polyhermes && cd ~/polyhermes && curl -fsSL https://raw.githubusercontent.com/WrBug/PolyHermes/main/deploy-interactive.sh -o deploy.sh && chmod +x deploy.sh && ./deploy.sh

Using wget:

mkdir -p ~/polyhermes && cd ~/polyhermes && wget -O deploy.sh https://raw.githubusercontent.com/WrBug/PolyHermes/main/deploy-interactive.sh && chmod +x deploy.sh && ./deploy.sh

This command will automatically:

• 📁 Create a dedicated working directory ~/polyhermes
• 📥 Download the deployment script
• ✅ Check Docker environment
• ⚙️ Configure all parameters interactively (press Enter for defaults)
• 🔐 Auto-generate secure random secrets
• 🚀 Download latest images and deploy

Or run directly via pipe (without saving file):

# curl method
mkdir -p ~/polyhermes && cd ~/polyhermes && curl -fsSL https://raw.githubusercontent.com/WrBug/PolyHermes/main/deploy-interactive.sh | bash

# wget method
mkdir -p ~/polyhermes && cd ~/polyhermes && wget -qO- https://raw.githubusercontent.com/WrBug/PolyHermes/main/deploy-interactive.sh | bash

Method 1: Download and Run Script Directly

# Download script
curl -O https://raw.githubusercontent.com/WrBug/PolyHermes/main/deploy-interactive.sh

# Add execute permission
chmod +x deploy-interactive.sh

# Run
./deploy-interactive.sh

Method 2: Run in Project Directory

git clone https://github.com/WrBug/PolyHermes.git
cd PolyHermes
./deploy-interactive.sh

📝 Usage Flow

After running the script, you will be guided through the following steps:

Step 1: Environment Check  → Check Docker/Docker Compose
Step 2: Configuration       → Interactive input (press Enter for defaults)
Step 3: Get Deploy Config   → Download docker-compose.prod.yml from GitHub
Step 4: Generate Env File   → Auto-generate .env
Step 5: Pull Docker Images  → Pull latest images from Docker Hub
Step 6: Deploy Services     → Start containers
Step 7: Health Check        → Verify services are running properly

⚡ Simplest Usage

Press Enter for all configuration items to use default values, the script will automatically:

• Use port 80 (application) and 3307 (MySQL)
• Generate 32-character database password
• Generate 128-character JWT secret
• Generate 64-character admin reset key
• Generate 64-character encryption key
• Configure reasonable log levels

Interactive Example

The script will prompt you for configuration one by one, press Enter to skip and use default values:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Step 2: Configuration
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

💡 All configurations are optional, press Enter to use default or auto-generated values

⚠ Secret config: Press Enter to auto-generate secure random secrets
⚠ Other config: Press Enter to use default values in parentheses

【Basic Configuration】
Will configure: Server port, MySQL port, Timezone
➤ Server port [Default: 80]: ⏎
➤ MySQL port (external access) [Default: 3307]: ⏎
➤ Timezone [Default: Asia/Shanghai]: ⏎

【Database Configuration】
Will configure: Database username, Database password
➤ Database username [Default: root]: ⏎
➤ Database password [Enter to auto-generate]: ⏎
[✓] Database password auto-generated (32 characters)

【Security Configuration】
Will configure: JWT secret, Admin password reset key, Data encryption key
➤ JWT secret [Enter to auto-generate]: ⏎
[✓] JWT secret auto-generated (128 characters)
➤ Admin password reset key [Enter to auto-generate]: ⏎
[✓] Admin reset key auto-generated (64 characters)
➤ Encryption key (for API Key encryption) [Enter to auto-generate]: ⏎
[✓] Encryption key auto-generated (64 characters)

【Log Configuration】
Will configure: Root log level, Application log level
Available levels: TRACE, DEBUG, INFO, WARN, ERROR, OFF
➤ Root log level (third-party libs) [Default: WARN]: ⏎
➤ Application log level [Default: INFO]: ⏎

【Other Configuration】
Will configure: Runtime environment, Auto-update policy, GitHub repo
➤ Spring Profile [Default: prod]: ⏎
➤ Allow prerelease updates (true/false) [Default: false]: ⏎
➤ GitHub repository [Default: WrBug/PolyHermes]: ⏎

🔧 Files Generated by Script

After running, the script will generate in the current directory:

1. docker-compose.prod.yml - Docker Compose config downloaded from GitHub (always latest)
2. .env - Environment variables file auto-generated based on your configuration

These two files contain all the configuration needed to run PolyHermes.

🌐 Post-Deployment Management

Quick Update (Recommended)

If you already have configuration files, running the script again will detect and ask:

./deploy-interactive.sh

【Existing Configuration Detected】
Found existing .env configuration file

Use existing configuration to update images directly? [Y/n]: ⏎

• Press Enter or input Y: Use existing config, pull latest images and update
• Input N: Reconfigure (existing config will be backed up)

Manual Management Commands

# View service status
docker compose -f docker-compose.prod.yml ps

# View logs
docker compose -f docker-compose.prod.yml logs -f

# Restart services
docker compose -f docker-compose.prod.yml restart

# Stop services
docker compose -f docker-compose.prod.yml down

# Update to latest version
docker pull wrbug/polyhermes:latest
docker compose -f docker-compose.prod.yml up -d

🔐 Security Recommendations

• Protect .env file: Contains sensitive information, never commit to version control
• Backup database regularly: Data is stored in Docker volume mysql-data
• Configure HTTPS for production: Recommend using Nginx or Caddy as reverse proxy

📞 Support

• GitHub Repository
• Issue Feedback
• Full Deployment Documentation

---

中文

✨ 核心特性

• 可在任意目录运行 - 无需下载项目源码
• 仅使用线上镜像 - 从 Docker Hub 拉取官方镜像
• 自动下载配置 - 从 GitHub 下载最新的 docker-compose.prod.yml
• 交互式配置 - 友好的问答式配置向导
• 自动生成密钥 - 所有敏感配置回车自动生成安全随机值

🚀 快速开始

一键安装（推荐）

使用 curl（推荐）：

mkdir -p ~/polyhermes && cd ~/polyhermes && curl -fsSL https://raw.githubusercontent.com/WrBug/PolyHermes/main/deploy-interactive.sh -o deploy.sh && chmod +x deploy.sh && ./deploy.sh

使用 wget：

mkdir -p ~/polyhermes && cd ~/polyhermes && wget -O deploy.sh https://raw.githubusercontent.com/WrBug/PolyHermes/main/deploy-interactive.sh && chmod +x deploy.sh && ./deploy.sh

这个命令会自动：

• 📁 创建专用工作目录 ~/polyhermes
• 📥 下载部署脚本
• ✅ 自动检查 Docker 环境
• ⚙️ 交互式配置所有参数（支持回车使用默认值）
• 🔐 自动生成安全的随机密钥
• 🚀 自动下载最新镜像并部署

或者直接通过管道运行（不保存文件）：

# curl 方式
mkdir -p ~/polyhermes && cd ~/polyhermes && curl -fsSL https://raw.githubusercontent.com/WrBug/PolyHermes/main/deploy-interactive.sh | bash

# wget 方式
mkdir -p ~/polyhermes && cd ~/polyhermes && wget -qO- https://raw.githubusercontent.com/WrBug/PolyHermes/main/deploy-interactive.sh | bash

方式一：直接下载脚本运行

# 下载脚本
curl -O https://raw.githubusercontent.com/WrBug/PolyHermes/main/deploy-interactive.sh

# 添加执行权限
chmod +x deploy-interactive.sh

# 运行
./deploy-interactive.sh

方式二：在项目目录中运行

git clone https://github.com/WrBug/PolyHermes.git
cd PolyHermes
./deploy-interactive.sh

📝 使用流程

运行脚本后，会引导你完成以下步骤：

步骤 1: 环境检查         → 检查 Docker/Docker Compose
步骤 2: 配置收集         → 交互式输入配置（可全部回车使用默认）
步骤 3: 获取部署配置     → 从 GitHub 下载 docker-compose.prod.yml
步骤 4: 生成环境变量文件 → 自动生成 .env
步骤 5: 拉取 Docker 镜像 → 从 Docker Hub 拉取最新镜像
步骤 6: 部署服务         → 启动容器
步骤 7: 健康检查         → 验证服务是否正常运行

⚡ 最简单的使用方式

所有配置项直接回车使用默认值，脚本会自动：

• 使用端口 80（应用）和 3307（MySQL）
• 生成 32 字符的数据库密码
• 生成 128 字符的 JWT 密钥
• 生成 64 字符的管理员重置密钥
• 生成 64 字符的加密密钥
• 配置合理的日志级别

交互示例

脚本会逐项提示你输入配置，直接按回车即可跳过使用默认值：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  步骤 2: 配置收集
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

💡 所有配置项均为可选，直接按回车即可使用默认值或自动生成

⚠ 密钥配置：回车将自动生成安全的随机密钥
⚠ 其他配置：回车将使用括号中的默认值

【基础配置】
将配置：服务器端口、MySQL端口、时区
➤ 服务器端口 [默认: 80]: ⏎
➤ MySQL 端口（外部访问） [默认: 3307]: ⏎
➤ 时区 [默认: Asia/Shanghai]: ⏎

【数据库配置】
将配置：数据库用户名、数据库密码
➤ 数据库用户名 [默认: root]: ⏎
➤ 数据库密码 [回车自动生成]: ⏎
[✓] 已自动生成数据库密码（32字符）

【安全配置】
将配置：JWT密钥、管理员密码重置密钥、数据加密密钥
➤ JWT 密钥 [回车自动生成]: ⏎
[✓] 已自动生成 JWT 密钥（128字符）
➤ 管理员密码重置密钥 [回车自动生成]: ⏎
[✓] 已自动生成管理员重置密钥（64字符）
➤ 加密密钥（用于加密 API Key） [回车自动生成]: ⏎
[✓] 已自动生成加密密钥（64字符）

【日志配置】
将配置：Root日志级别、应用日志级别
可选级别: TRACE, DEBUG, INFO, WARN, ERROR, OFF
➤ Root 日志级别（第三方库） [默认: WARN]: ⏎
➤ 应用日志级别 [默认: INFO]: ⏎

【其他配置】
将配置：运行环境、自动更新策略、GitHub仓库
➤ Spring Profile [默认: prod]: ⏎
➤ 允许预发布版本更新 (true/false) [默认: false]: ⏎
➤ GitHub 仓库 [默认: WrBug/PolyHermes]: ⏎

🔧 脚本生成的文件

脚本运行后会在当前目录生成：

1. docker-compose.prod.yml - 从 GitHub 下载的 Docker Compose 配置文件（始终保持最新）
2. .env - 根据你的配置自动生成的环境变量文件

这两个文件包含了运行 PolyHermes 所需的全部配置。

🌐 部署后管理

快速更新（推荐）

如果已有配置文件，再次运行脚本时会自动检测并询问：

./deploy-interactive.sh

【检测到现有配置】
发现已存在的 .env 配置文件

是否使用现有配置直接更新镜像？[Y/n]: ⏎

• 回车或输入 Y：使用现有配置，直接拉取最新镜像并更新
• 输入 N：重新配置（会备份现有配置）

手动管理命令

# 查看服务状态
docker compose -f docker-compose.prod.yml ps

# 查看日志
docker compose -f docker-compose.prod.yml logs -f

# 重启服务
docker compose -f docker-compose.prod.yml restart

# 停止服务
docker compose -f docker-compose.prod.yml down

# 更新到最新版本
docker pull wrbug/polyhermes:latest
docker compose -f docker-compose.prod.yml up -d

🔐 安全建议

• 保护 .env 文件：其中包含敏感信息，切勿提交到版本控制
• 定期备份数据库：数据存储在 Docker volume mysql-data 中
• 生产环境配置 HTTPS：建议使用 Nginx 或 Caddy 作为反向代理

📞 获取支持

• GitHub 仓库
• 问题反馈
• 完整部署文档