nuccess/nuclos-server

Nuclos应用服务器Docker镜像

镜像概述

本镜像包含Nuclos应用服务器，由自动化流水线构建并发布至Docker Hub。基于eclipse-temurin:17-noble基础镜像，支持Docker Content Trust（DCT）签名；Java Webstart已不再支持，数据库和密钥库密码需通过/opt/nuclos/secrets卷中的文件配置。

核心功能

1. 多环境适配：支持开发、测试、生产环境的灵活部署方案；
2. 数据库兼容：提供嵌入式PostgreSQL（镜像标签以-with-db结尾）或独立Nuclos-DB两种模式；
3. 开发模式：启用代码自动编译、Java调试端口（8000）及Webclient REST探索器；
4. 集群支持：实现主从节点配置，满足高可用需求；
5. 安全管理：通过secrets卷管理敏感密码，支持SSL密钥库配置；
6. 数据持久化：备份、文档附件、日志等目录可映射至宿主机；
7. 参数自定义：通过环境变量调整端口、内存、时区、数据库连接池等参数。

使用场景

开发环境（最新版本）

使用嵌入式PostgreSQL的默认开发环境：

shell
docker run --rm -d --name nuclos-dev -p 8060:8080 -p 5432:5432 -e DOCKER_NUCLOS_PORT=8060 \
-e DEVELOPMENT=true -e TZ=Europe/Berlin -e LOCALE=de_DE.UTF-8 \
docker.xuanyuan.run/nuccess/nuclos-server:latest-with-db

独立数据库的开发环境（需先启动nuclos-db容器）：

shell
docker run --rm -d --name nuclos-dev -p 8060:8080 -e DOCKER_NUCLOS_PORT=8060 \
-e DB_SCHEMA=dev -e DEVELOPMENT=true -e TZ=Europe/Berlin -e LOCALE=de_DE.UTF-8 \
--volumes-from nuclos-db --link nuclos-db:POSTGRES \
docker.xuanyuan.run/nuccess/nuclos-server

生产环境（v4.2026.19.1）

推荐映射文档附件、备份等目录，配置SSL密钥库：

shell
docker run -d --name nuclos-prod -p 8040:8080 -e DOCKER_NUCLOS_PORT=8040 \
-e DB_SCHEMA=production \
-v /Users/Maik/Nuclos/Docker/vol-nuclos-secrets:/opt/nuclos/secrets:ro \
-v /Users/Maik/Nuclos/Docker/vol-nuclos-keystore:/opt/nuclos/keystore:ro \
-v /Users/Maik/Nuclos/Docker/vol-nuclos-backups:/opt/nuclos/backups \
-v /Users/Maik/Nuclos/Docker/vol-nuclos-documents:/opt/nuclos/home/data/documents \
-e TOTAL_RAM_GB=4 -e TZ=Europe/Berlin -e LOCALE=de_DE.UTF-8 \
--volumes-from nuclos-db --link nuclos-db:POSTGRES \
docker.xuanyuan.run/nuccess/nuclos-server:4.2026.19.1

⚠️ 注意：生产、测试和开发环境请勿使用同一Nuclos-DB实例，否则恢复备份时可能删除现有数据。

测试环境（v4.2026.19.1）

基于生产备份恢复的测试环境：

shell
docker run --rm -d --name nuclos-test -p 8050:8080 -e DOCKER_NUCLOS_PORT=8050 \
-e DB_SCHEMA=test \
-v /Users/Maik/Nuclos/Docker/vol-nuclos-backups:/opt/nuclos/backups \
-v /Users/Maik/Nuclos/Docker/vol-nuclos-restore:/opt/nuclos/restorescripts:ro \
-e DEVELOPMENT=true -e TZ=Europe/Berlin -e LOCALE=de_DE.UTF-8 \
--volumes-from nuclos-db --link nuclos-db:POSTGRES \
docker.xuanyuan.run/nuccess/nuclos-server:4.2026.19.1

恢复后自动执行/opt/nuclos/restorescripts目录下的SQL脚本（如修改实例名称、禁用生产功能等）。

客户端访问

• Web客户端：访问http://localhost:8060（端口需与映射一致）；
• 桌面客户端：通过Nuclos Launcher连接，服务器地址为nuclos://localhost:8060/nuclos；
• 默认用户：nuclos（无密码）。

数据卷配置

主要数据卷：

• /opt/nuclos/secrets：存储db_password和keystore_password文件；
• /opt/nuclos/backups：备份文件目录；
• /opt/nuclos/home/data/documents：文档附件存储；
• /opt/nuclos/home/logs：日志文件目录；
• /opt/nuclos/keystore：SSL密钥库文件目录；
• /opt/nuclos/restorescripts：恢复后执行的SQL脚本目录。

环境变量配置

关键环境变量：

• DOCKER_NUCLOS_PORT：映射端口（需与-p参数一致）；
• TOTAL_RAM_GB：容器可用总内存（默认2GB）；
• DEVELOPMENT：启用开发模式（true/false）；
• TZ：时区（默认Europe/Berlin）；
• LOCALE：区域设置（默认de_DE.UTF-8）；
• DB_SCHEMA：数据库schema名称（默认nuclos）；
• CLUSTER_MODE：启用集群模式（true/false）；
• CLUSTER_NODE_TYPE：集群节点类型（master/slave）。