Docker 安装
当前开发源码已拆分为 Admin 前端与 Go API，尚未正式发布；Go 版本的管理库和服务名与本页不同，源码部署请使用 API 部署说明。
推荐使用完整离线包安装。先阅读部署概览，以下操作在解压后的包根目录执行。
系统要求
- 容器运行环境：
- Linux：Docker Engine 与 Docker Compose v2
- macOS：OrbStack 或 Docker Desktop
- Windows：Docker Desktop
- Python 3.11 或更高版本。
- 足够空间保存约数 GB 的压缩包、解压目录、Docker 镜像和数据库。
获取离线包
以下以已取得的完整 happyro-v0.5.0.zip 为例。公开下载与 SHA-256 以下载页为准。
unzip happyro-v0.5.0.zip
cd happyro-v0.5.0Linux 和 macOS 可以使用上述命令；Windows 可以在文件资源管理器中解压 ZIP。解压后应保留唯一的 happyro-v0.5.0/ 根目录及其中的空 data/ 子目录。
旧版如有配套拆分交付包，必须合并同一版本的两部分，不能跨版本混用；v0.5.0 默认交付完整 ZIP，实际交付信息以正式发布记录为准。
校验并导入镜像
所有命令都在解压后的包根目录执行：
python3 tools/deployment/manage.py verify --directory .
python3 tools/deployment/manage.py import-images --directory .
python3 tools/deployment/manage.py initialize --directory .verify 检查配置、资源和两个架构的镜像归档；import-images 根据 Docker daemon 架构只导入所需的四个镜像；initialize 创建 .env、随机运行密钥及默认 custom 目录，不启动服务。仅首次空环境运行；已有环境按升级流程处理。
配置与启动
启动前按访问地址与目录配置设置 .env。域名入口另见HTTPS 与反向代理。
启动游戏
python3 tools/deployment/manage.py deploy --directory .
docker compose ps -adeploy 使用已导入的本版镜像，不会拉取或现场构建；先等待数据库健康并执行登录会话表及撤销触发器升级，成功后才启动整栈，失败则停止后续启动。客户端、Gateway、Server 与 Database 须配套更新，详见升级流程。启动完成后，可按下面几项检查运行状态。
服务状态
以下七个服务应显示为 healthy：
| 服务 | 容器 | 用途 |
|---|---|---|
| Database | happyro-database | 游戏与后台数据库 |
| Login | happyro-login | 游戏账号登录 |
| Char | happyro-char | 角色选择与角色数据 |
| Map | happyro-map | 地图、战斗和 NPC |
| Web API | happyro-web-api | 游戏控制与资料接口 |
| Gateway | happyro-gateway | 游戏网页、资源与 WebSocket 入口 |
| Admin | happyro-admin | 游戏后台 |
初始化容器 happyro-admin-init 应执行完成并以状态码 0 退出。
访问入口
默认仅限部署机器本机访问：
- 游戏：
http://127.0.0.1:3338/applications/pwa/index.html - 游戏后台：
http://127.0.0.1:8000
需要让局域网其他设备访问时，将 .env 中的公开地址和 ADMIN_STATEFUL_DOMAINS 同步改为部署机器的局域网 IP。
默认账号
首次使用空数据库启动时会创建：
| 用途 | 用户名 | 密码 | 权限 |
|---|---|---|---|
| 游戏 | happyro | happyro | GM |
| 游戏后台 | admin | admin | 超级管理员 |
默认角色：罗安
从 v0.5.0 起，首次空库初始化会在 happyro/happyro 的第一个角色位自动创建拍照角色“罗安”，登录后即可选择进入游戏。
| 项目 | 初始配置 |
|---|---|
| 性别与职业 | 男剑士，职业 ID 1，Base 99 / Job 50 |
| 六维属性 | STR 70、AGI 60、VIT 40、INT 10、DEX 40、LUK 1 |
| 生命与魔力 | HP 5758、SP 228，均为满值 |
| 点数 | 剩余属性点、技能点、特性点均为 0 |
| 金钱 | 10,000 Zeny |
| 外观 | 发型 1、默认颜色，无头饰 |
| 装备与物品 | 普通剑（1101，已装备）、红色药水 ×100、蓝色药水 ×100、波利蛋 ×1 |
| 宠物 | 波利已收回蛋，亲密度 950、饥饿度 100，可正常孵化 |
| 出生位置 | 普隆德拉 prontera，164,185 |
| 存档位置 | 普隆德拉 prontera，159,189 |
已学技能：基础技能 Lv.9、剑术修炼 Lv.10、增加 HP 恢复 Lv.4、狂击 Lv.10、怒爆 Lv.10、挑衅 Lv.5、钢铁之心 Lv.10。前六个快捷栏依次配置狂击、怒爆、挑衅、钢铁之心、红色药水、蓝色药水，技能使用上述等级，桌面与移动端共用。
不带截图账号的好友、邮件、队伍、公会或测试记录。此配置仅用于新数据库，重启或升级已有数据库不会创建、替换角色或补发物品；本机专用截图账号 readmecapture 不受影响。