soupbowl/opensimulator

OpenSimulator Docker镜像文档

镜像概述

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

支持的标签及对应Dockerfile链接

• https://github.com/soup-bowl/opensimulator-docker/blob/main/build/latest/Dockerfile
• https://github.com/soup-bowl/opensimulator-docker/blob/main/build/latest/Dockerfile.noscreen
• https://github.com/soup-bowl/opensimulator-docker/blob/main/build/latest/Dockerfile.mono
• https://github.com/soup-bowl/opensimulator-docker/blob/main/build/latest/Dockerfile.mono
• https://github.com/soup-bowl/opensimulator-docker/blob/main/beta/source/Dockerfile
• https://github.com/soup-bowl/opensimulator-docker/blob/main/beta/alpine/Dockerfile

核心功能与特性

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

使用场景

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

使用方法

基本部署

0.9.3.0及以上版本使用.NET框架，由于已知bug（https://github.com/soup-bowl/opensimulator-docker/issues/9%EF%BC%89%EF%BC%8C%E9%95%9C%E5%83%8F%E4%BD%BF%E7%94%A8screen%E9%98%B2%E6%AD%A2%E4%BC%9A%E8%AF%9D%E6%84%8F%E5%A4%96%E7%BB%93%E6%9D%9F%E3%80%820.9.2.2%E5%8F%8A%E4%BB%A5%E4%B8%8B%E7%89%88%E6%9C%AC%E4%BD%BF%E7%94%A8Mono%E6%A1%86%E6%9E%B6%E3%80%82

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

示例

更多使用示例可参考https://github.com/soup-bowl/opensim-sandbox%E3%80%82

镜像变体

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的前沿变体，跟踪https://github.com/soup-bowl/opensimulator-docker/issues/1%E8%BF%9B%E5%BA%A6%E3%80%82**%E7%94%B1%E4%BA%8EOpenSimulator%E5%B7%B2%E5%BC%83%E7%94%A8Mono%EF%BC%8C%E6%AD%A4%E5%8F%98%E4%BD%93%E5%8F%AF%E8%83%BD%E4%BF%AE%E8%AE%A2%E6%88%96%E7%A7%BB%E9%99%A4%E3%80%82**

soupbowl/opensimulator:source

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

源代码

• Docker镜像源代码：https://github.com/soup-bowl/opensimulator-docker
• OpenSimulator服务器软件源代码：官方网站