soupbowl/opensimulator Docker 镜像 - 轩辕镜像

OpenSimulator Docker镜像文档

镜像概述

OpenSimulator是一款开源的多平台、多用户3D应用服务器，可用于创建虚拟环境（或虚拟世界），并支持通过多种客户端和协议访问。本非官方Docker配置旨在简化服务器的测试和通用用途部署。注意：此镜像仍处于实验阶段，可能存在bug。

支持的标签及对应Dockerfile链接

• latest, 0.9, 0.9.3, 0.9.3.0
• 0.9.3-noscreen, 0.9.3.0-noscreen
• 0.9.2, 0.9.2.2
• 0.9.2.1
• source
• alpine-beta

核心功能与特性

• 支持多平台部署，基于Docker容器化技术
• 可配置网格名称、欢迎消息、区域名称、庄园属性等核心参数
• 支持SQLite和MySQL数据库引擎
• 提供多种物理引擎选择（BulletSim、OpenDynamicsEngine、ubODE、basicphysics）
• 包含screen工具以支持服务器管理命令交互
• 支持ARM64架构（物理引擎存在限制）

使用场景

• 虚拟世界服务器测试与开发
• 小型虚拟社区搭建
• 教育或演示用虚拟环境部署
• OpenSimulator功能验证与学习

使用方法

基本部署

0.9.3.0及以上版本使用.NET框架，由于已知bug（参见#9），镜像使用screen防止会话意外结束。0.9.2.2及以下版本使用Mono框架。

bash
docker run -it -d --name opensim -p 9000:9000 -p 9000:9000/udp soupbowl/opensimulator:latest

环境变量配置

可通过以下环境变量自定义服务器设置：

• GRID_NAME：定义网格名称
• GRID_WELCOME：登录屏幕显示的自定义消息
• REGION_NAME：定义区域名称
• ESTATE_NAME：定义庄园名称
• ESTATE_OWNER_NAME：庄园所有者名称（格式为"名 姓"，同时创建登录账户）
• ESTATE_OWNER_PASSWORD：登录密码
• ESTATE_OWNER_UUID：自定义UUID（可选）
• ESTATE_OWNER_EMAIL：庄园所有者***
• DATABASE_ENGINE：数据库引擎（支持sqlite和mysql，默认为sqlite）
• MYSQL_SERVER、MYSQL_DATABASE、MYSQL_USER、MYSQL_PASSWORD：当DATABASE_ENGINE为mysql时的数据库连接参数
• PHYSICS_ENGINE：物理引擎（默认BulletSim，可选OpenDynamicsEngine、ubODE、basicphysics）

客户端连接

服务器运行后，可通过localhost:9000连接。在Firestorm Viewer中，依次进入偏好设置→OpenSim→添加新网格，输入localhost:9000即可登录。

若未通过环境变量或自定义配置修改，默认登录用户名为Foo bar，密码为password。

自定义配置

环境变量仅覆盖部分常用设置，如需完整配置，可挂载自定义配置文件（建议设为只读）。工作目录为/opt/opensim/bin/，例如挂载自定义OpenSim.ini：

bash
-v /path/to/local/OpenSim.ini:/opt/opensim/bin/OpenSim.ini:ro

SQLite数据持久化

默认SQLite数据库存储在容器内，容器删除后数据会丢失。可通过挂载数据目录实现持久化：

bash
docker run -d --name opensim -p 9000:9000 -p 9000:9000/udp -v /path/on/your/system:/opt/opensim/bin/sqlite-database soupbowl/opensimulator:latest

注意：使用自定义SQLiteStandalone.ini时，此配置不生效。

限制

服务器管理命令

目前无法从外部TTY管理服务器，docker attach opensim可能显示空白。可通过以下命令访问管理界面：

bash
docker exec -it <容器名称> screen -r -d OpenSim

按ctrl + a然后d可退出screen会话。若需不使用screen，可修改Dockerfile：

dockerfile
FROM soupbowl/opensimulator:latest
CMD [ "dotnet",  "OpenSim.dll" ]

ARM架构物理引擎支持

ARM64架构构建可用，但物理引擎存在限制：BulletSim和OpenDynamicsEngine（ODE）会导致致命错误，需使用基础物理引擎：

bash
-e PHYSICS_ENGINE=basicphysics

或修改配置文件：

ini
[Startup]
   physics = basicphysics

示例

更多使用示例可参考此仓库。

镜像变体

soupbowl/opensimulator:latest

基于官方.NET 8镜像构建的最新OpenSimulator版本。0.9.2.2及以下版本使用Mono框架。

soupbowl/opensimulator:<version>-noscreen

0.9.3.0及以上版本的无screen构建，为临时变体，解决后将移除。

soupbowl/opensimulator:alpine-beta

基于Alpine的前沿变体，跟踪#1工单进度。由于OpenSimulator已弃用Mono，此变体可能修订或移除。

soupbowl/opensimulator:source

从OpenSimulator仓库获取最新代码编译的前沿版本，高度不稳定，按需构建。

源代码

• Docker镜像源代码：GitHub仓库
• OpenSimulator服务器软件源代码：官方网站