orcpub/datomic Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Dungeon Master's Vault - Community Edition

镜像概述

Dungeon Master's Vault - Community Edition是一个Web服务器，允许用户自建D&D 5th Edition（龙与地下城5版）角色生成器网站。该项目从2019年1月7日的OrcPub2代码分叉而来，并进行了功能改进，提供角色创建、属性计算、数据存储等核心功能，支持通过Docker容器化部署。

核心功能与特性

• D&D 5e角色生成：提供完整的角色创建流程，支持种族、职业、技能、属性等选项配置
• 数据持久化：基于Datomic数据库存储角色和魔法物品信息，确保数据安全
• Docker化部署：包含三个核心容器（Datomic数据库、应用服务、Nginx反向代理），简化部署流程
• 自定义配置：通过环境变量灵活配置SMTP邮件服务、数据库密码、安全签名等
• Homebrew支持：支持导入自定义Orcbrew文件，扩展角色选项
• SSL加密：集成Nginx支持HTTPS，保障数据传输安全

使用场景与适用范围

• 桌面游戏团体：自建角色管理平台，方便D&D 5e玩家创建和管理角色
• 游戏开发者：作为D&D相关应用的基础框架，扩展自定义功能
• 教育场景：用于教学D&D规则和角色构建逻辑
• 个人爱好者：搭建个人角色库，管理多个游戏角色数据

使用方法与配置说明

环境准备

需提前安装以下工具：

• git
• Docker及Docker Compose（支持Windows或Unix系统）
• SSL证书（自签名或CA颁发）
• SMTP中继服务

部署步骤

1. 克隆代码仓库

bash
# 无GitHub账号
git clone [***]

# 有GitHub账号
git clone ***:Orcpub/orcpub.git

2. 配置docker-compose.yaml

编辑docker-compose.yaml文件，设置关键环境变量：

yaml
environment:
  EMAIL_SERVER_URL: ''           # SMTP服务器DNS名称
  EMAIL_ACCESS_KEY: ''           # 邮件服务器用户名
  EMAIL_SECRET_KEY: ''           # 邮件服务器密码
  EMAIL_SERVER_PORT: 587         # 邮件服务器端口
  EMAIL_FROM_ADDRESS: ''         # 发件人***，默认***
  EMAIL_ERRORS_TO: ''            # 错误报告接收***
  EMAIL_SSL: 'false'             # 是否使用SSL（Gmail需启用）
  EMAIL_TLS: 'false'             # 是否使用TLS
  DATOMIC_URL: datomic:free://datomic:4334/orcpub?password=yourpassword  # 数据库URL
  ADMIN_PASSWORD: supersecretpassword  # Datomic管理员密码（需与DATOMIC_PASSWORD不同）
  DATOMIC_PASSWORD: yourpassword       # 应用数据库密码
  SIGNATURE: '<change me to something unique>'  # 密码哈希密钥（建议20+字符）

3. 配置SSL证书

• 生成自签名证书（快速测试用）：

  bash
  # Unix系统
  ./deploy/snakeoil.sh
  
  # Windows系统（需先安装OpenSSL，可通过choco install openssl）
  ./deploy/snakeoil.bat
  

• 使用现有证书：修改Nginx服务的卷挂载配置，指向实际证书路径：

  yaml
  volumes:
    - ./deploy/nginx.conf:/etc/nginx/conf.d/default.conf
    - /path/to/your/cert.crt:/etc/nginx/snakeoil.crt
    - /path/to/your/key.key:/etc/nginx/snakeoil.key
  

4. 启动容器

bash
# 拉取镜像
docker-compose pull

# 启动服务（前台运行，查看日志）
docker-compose up

# 或后台运行
docker-compose up -d

服务启动后，可通过https://localhost访问角色生成器网站。

数据管理

数据存储

• 角色数据存储在./data目录（Datomic数据库文件）
• 备份：停止服务后复制./data目录
• 重置：删除./data目录后重启服务

日志管理

• 日志文件位于./logs目录，包含Datomic运行日志
• 定期清理日志文件以避免磁盘空间占用过大

自定义Homebrew内容

将自定义Orcbrew文件合并为单个homebrew.orcbrew，放置于./deploy/homebrew/目录，系统会自动加载。

开发指南

构建自定义镜像

如需从源码构建Docker镜像，使用docker-compose-build.yaml配置：

1. 重命名配置文件：

   bash
   mv docker-compose-build.yaml docker-compose.yaml
   

2. 构建镜像：

   bash
   docker-compose build
   

3. 启动服务：

   bash
   docker-compose up
   

开发环境依赖

• Java（OpenJDK或Oracle JDK）
• Datomic（免费版）
• Leiningen（Clojure构建工具）
• Git

本地开发步骤

1. 启动Datomic transactor：

   bash
   # Windows
   bin\transactor config/samples/free-transactor-template.properties
   
   # Mac/Unix
   bin/transactor config/samples/free-transactor-template.properties
   

2. 启动REPL：

   bash
   lein with-profile +start-server repl
   

3. 启动Figwheel（前端热加载）：

   bash
   lein figwheel
   

4. 在REPL中初始化数据库并启动服务器：

   clojure
   user=> (init-database)  ; 仅首次运行需执行
   user=> (start-server)
   

注意事项

• 数据库密码（ADMIN_PASSWORD和DATOMIC_PASSWORD）需妥善保管，修改密码需通过环境变量ADMIN_PASSWORD_OLD和DATOMIC_PASSWORD_OLD过渡
• 生产环境建议使用CA颁发的SSL证书，避免使用自签名证书
• 定期备份./data目录以防数据丢失
• 日志文件可能快速增长，建议配置日志轮转策略

许可证

本项目基于EPL-2.0许可证开源。