mopfelwinrux/urbit-umbrel

Urbit on Umbrel Docker镜像

镜像概述

本Docker镜像专为在Umbrel个人服务器平台上部署和运行Urbit设计，旨在简化Urbit节点的配置流程，确保与Umbrel环境的兼容性。通过预配置必要依赖和环境参数，用户无需手动处理复杂的系统适配，即可快速在Umbrel上启动并运行Urbit节点。

核心功能与特性

• Umbrel环境深度适配：针对Umbrel的网络架构、存储布局及权限模型优化，确保镜像在Umbrel生态中稳定运行。
• 简化部署流程：集成Urbit运行所需的基础依赖（如网络配置、存储映射等），减少手动配置步骤，降低技术门槛。
• 轻量级设计：采用精简基础镜像，最小化资源占用，适配Umbrel设备的硬件配置。
• 数据持久化支持：默认配置数据卷映射，确保Urbit节点数据（如舰船状态、网络配置）在容器重启后不丢失。

使用场景与适用范围

适用于Umbrel个人服务器用户，需在Umbrel平台上部署Urbit节点、参与Urbit去中心化网络或运行Urbit应用的场景。尤其适合希望避免复杂手动配置的非专业用户，或需要在Umbrel生态中快速集成Urbit功能的开发者。

使用方法与配置说明

前提条件

• 已安装并运行Umbrel个人服务器（确保Umbrel服务正常启动，网络通畅）。
• 本地环境已安装Docker及Docker Compose（通常Umbrel已预装Docker环境）。

基本部署命令

通过以下命令快速启动Urbit节点（需根据实际环境调整路径参数）：

bash
docker run -d \
  --name urbit-umbrel \
  --network=umbrel_main_network \  # 接入Umbrel主网络（具体网络名称以Umbrel实际配置为准）
  -v /home/umbrel/app-data/urbit:/urbit/data \  # 挂载Umbrel持久化存储目录
  -p 8080:8080 \  # 端口映射（Urbit Web界面，根据需求调整）
  urbit-on-umbrel:latest

关键配置参数

环境变量

数据卷挂载

• 必须挂载Umbrel的持久化存储目录（如/home/umbrel/app-data/urbit）至容器内/urbit/data，确保Urbit数据在容器重启或升级后不丢失。

验证与管理

• 查看容器状态：docker ps | grep urbit-umbrel
• 查看日志：docker logs -f urbit-umbrel
• 停止容器：docker stop urbit-umbrel
• 重启容器：docker restart urbit-umbrel

注意事项

• 确保Umbrel设备有足够的存储空间（建议至少10GB空闲空间）。
• 首次启动时，Urbit节点需要时间初始化（可能持续数分钟），请通过日志确认启动状态。
• 如需自定义网络配置或端口映射，需确保与Umbrel防火墙规则兼容。