新闻详情

新闻详情

首页 / 资讯中心 / 详情

在本地部署 Lore Server:二进制与 Docker 两种持久化实战指南

发布时间:2026/9/25 4:36:15来源:尧图网络
在本地部署 Lore Server:二进制与 Docker 两种持久化实战指南
版本控制后端【免费下载链接】loreLore is a next-generation, open source version control system项目地址https://gitcode.com/gh_mirrors/lore6/lore点击查看免费下载loreserver是 Lore 版本控制系统的服务端组件它是仓库数据的集中来源source of truth——团队 push、clone、解决冲突时连接的核心端点。本文将带你用二进制直跑与 Docker 容器两种方式部署可持久化的本地 Lore Server并深入其配置分层机制与零配置默认行为让你既能快速跑通演示实例也能搭建一个存储不随重启丢失、证书跨重启稳定的可靠服务器。前置条件在开始之前请确认满足以下条件loreCLI 已安装并加入 PATHloreserver本身提供服务但真正的日常操作创建仓库、push、clone由 lore CLI 完成。安装方式见 Install the Lore CLI。端口可用主机上需释放41337TCP 与 UDP 双协议和41339TCP。前者承载 QUICUDP与 gRPCTCP流量后者承载 HTTP 服务。OpenSSL用于生成自签名证书持久化部署必需。选择部署路径二进制与 Docker 两条路径互斥且各自完整独立——请自上而下完整跟随其中一条不要混用从二进制运行依赖更少、原生性能。适合希望直接在主机上运行loreserver的场景。使用 Docker 运行隔离的容器环境。适合不想在主机上放置二进制的场景——但需要注意 Apple Silicon 上构建时的linux/amd64仿真问题下文详解。无论选择哪条路径默认情况下服务器都以一次性演示实例的方式启动真正的生产使用需要额外完成持久化配置步骤。从二进制运行1. 获取二进制下载适用于你平台的发布构建macOS / Linuxcurl -fsSL https://raw.githubusercontent.com/EpicGames/lore/main/scripts/install.sh | bash -s -- --serverWindows$env:LORE_SERVER1; irm https://raw.githubusercontent.com/EpicGames/lore/main/scripts/install.ps1 | iex或者通过 Scoop 安装scoop install loreserver[!NOTE]install.sh的--server标志只安装loreserver跳过loreCLI 与自动启动安装目录默认是~/.local/bin可通过--install-dir dir或LORE_INSTALL_DIR环境变量调整对应 PowerShell 脚本的-InstallDir。仓库内的 scripts/install.sh 会从 GitHub Releases 拉取与uname -s/uname -m匹配的发布包并自动把安装目录写入 shell rc 文件以保证 PATH 生效。2. 使用默认配置启动macOS / Linux~/.local/bin/loreserverWindows $env:USERPROFILE\bin\loreserver.exe[!NOTE] 以上是默认安装位置。如果你安装时传了--install-dir/-InstallDir或LORE_INSTALL_DIR请使用那个路径。以这种方式且不带任何配置启动时服务器行为如下以前台进程运行Ctrl C停止在41337端口监听 QUIC 与 gRPCQUIC 走 UDPgRPC 走 TCP在41339端口监听 HTTP使用每次重启都会重新生成的自签名证书mutable store 与 immutable store 存放在操作系统临时目录下系统重启即清空。这套零配置行为非常适合概念验证或演示但不适合存放重要数据。验证完毕后Ctrl C停止进入第 3 步。3. 持久化配置一个持久化的 Lore Server 至少需要满足两点mutable / immutable store 写入真实位置以及一个跨重启存活的 QUIC 证书。两者都可以写在一个local.toml配置文件中服务器会将其叠加在默认配置之上。先创建服务器目录结构macOS / Linuxmkdir -p /opt/loreserver/config /opt/loreserver/certsWindowsNew-Item -ItemType Directory -Force C:\loreserver\config, C:\loreserver\certs生成对localhost有效的自签名证书macOS / Linuxopenssl req -x509 -newkey rsa:2048 -nodes \ -keyout /opt/loreserver/certs/key.pem \ -out /opt/loreserver/certs/cert.pem \ -days 365 -subj /CNlocalhost -addext subjectAltNameIP:127.0.0.1,DNS:localhostWindowsopenssl req -x509 -newkey rsa:2048 -nodes -keyout C:\loreserver\certs\key.pem -out C:\loreserver\certs\cert.pem -days 365 -subj /CNlocalhost -addext subjectAltNameIP:127.0.0.1,DNS:localhost创建配置文件macOS / Linux— 创建/opt/loreserver/config/local.toml[server.quic.certificate] cert_file /opt/loreserver/certs/cert.pem pkey_file /opt/loreserver/certs/key.pem [immutable_store.local] path /opt/loreserver/store flush_delay_seconds 10 [mutable_store.local] path /opt/loreserver/store flush_delay_seconds 10Windows— 创建C:\loreserver\config\local.toml[server.quic.certificate] cert_file C:\\loreserver\\certs\\cert.pem pkey_file C:\\loreserver\\certs\\key.pem [immutable_store.local] path C:\\loreserver\\store flush_delay_seconds 10 [mutable_store.local] path C:\\loreserver\\store flush_delay_seconds 10这是持久化 Lore Server 的最小推荐配置两个 store 都指向固定路径并用你自己的证书替换临时证书。flush_delay_seconds 10表示后台每 10 秒将内存变更刷新到磁盘。配置就绪后启动服务器并传入配置目录位置macOS / Linux~/.local/bin/loreserver --config /opt/loreserver/configWindows $env:USERPROFILE\bin\loreserver.exe --config C:\loreserver\config[!NOTE] 完整的 loreserver 可配置项与local.toml字段参考见 Lore Server 配置参考。关于配置分层的补充说明从源码看local.toml之所以能叠加在默认配置之上是因为loreserver的配置加载采用分层合并模型Settings::load见 lore-server/src/settings.rs先从编译期烧录进二进制的default.toml起步include_str!(../config/default.toml)即 lore-server/config/default.toml再依次叠加可选文件——磁盘上的default.toml、environment.toml、区域变体environment_region.toml、local.toml最后应用LORE__前缀的环境变量覆盖。文件按字段级合并后加载的源只覆盖它设置的字段其余字段保持不变。--config指定配置目录未指定时默认取工作目录下的相对路径lore-server/config等价环境变量为LORE_CONFIG_PATH。--env选择环境文件默认local等价环境变量为LORE_ENV。local.toml是最后加载的文件层覆盖其上的所有文件LORE__环境变量则最后生效、优先级最高。注意数组字段如topology.fixed.peers是整体替换而非跨层合并。这也解释了本文local.toml只需写 store 路径与证书即可生效其余字段继续沿用编译期默认值。使用 Docker 运行1. 构建镜像需要 DockerWindows 上还需要 WSL2并在本地克隆了 Lore 仓库。构建镜像会编译服务器因此需要数 GB 可用内存。在仓库根目录执行docker build --platform linux/amd64 -f lore-server/Dockerfile -t lore-server .[!NOTE] 在 Apple Silicon 或 Windowsarm64 与 amd64 均如此上构建与运行都按示例使用--platform linux/amd64。原因在于linux/arm64服务器镜像针对 AWS Graviton3SVE 指令集优化而 Apple Silicon / Windows 的 CPU 并不具备该指令集。从 lore-server/Dockerfile 可以看到arm64 构建走--features lore-base/neoverse-512tvb与.cargo/neoverse-512tvb.toml的专用配置。2. 使用默认配置运行同时映射41337的 TCP 与 UDP 两侧以及 HTTP 端口41339macOS / Linuxdocker run -d --name lore-server \ -p 41337:41337/tcp \ -p 41337:41337/udp \ -p 41339:41339 \ lore-serverWindowsdocker run -d --name lore-server -p 41337:41337/tcp -p 41337:41337/udp -p 41339:41339 lore-server镜像把数据存放在容器内的/data目录下并生成临时证书因此它启动时没有任何自身配置、认证处于关闭状态。与二进制的默认行为一致这是一个可丢弃的实例证书是临时的容器数据随容器移除而丢失。镜像的默认配置来自 Dockerfile 中写入的docker.toml把两个本地 store 的path指向/data并设置LORE_CONFIG_PATH/etc/lore/config、LORE_ENVdocker详见 lore-server/Dockerfile。3. 持久化配置持久化 Lore Server 最少需要mutable / immutable store 写入真实位置 跨重启存活的 QUIC 证书。构建好的容器镜像已经配置为把数据存在/data、从/etc/lore/config加载附加配置。持久化步骤为为/data创建 Docker 卷以保证数据在容器移除后仍存活在宿主机生成 QUIC 证书创建指向该证书的local.toml然后把两者 bind-mount 进容器。生成对localhost有效的自签名证书macOS / Linuxopenssl req -x509 -newkey rsa:2048 -nodes -keyout key.pem -out cert.pem -days 365 \ -subj /CNlocalhost -addext subjectAltNameIP:127.0.0.1,DNS:localhostWindowsopenssl req -x509 -newkey rsa:2048 -nodes -keyout key.pem -out cert.pem -days 365 -subj /CNlocalhost -addext subjectAltNameIP:127.0.0.1,DNS:localhost创建指向该证书的local.toml—— 镜像已把数据存放在/data因此证书是唯一需要的 loreserver 配置覆盖[server.quic.certificate] cert_file /etc/lore/cert.pem pkey_file /etc/lore/key.pem停止临时容器然后携带证书、覆盖文件与宿主机数据目录重新运行macOS / Linuxdocker stop lore-server docker rm lore-server docker run -d --name lore-server \ -p 41337:41337/tcp \ -p 41337:41337/udp \ -p 41339:41339 \ -v $PWD/cert.pem:/etc/lore/cert.pem:ro \ -v $PWD/key.pem:/etc/lore/key.pem:ro \ -v $PWD/local.toml:/etc/lore/config/local.toml:ro \ -v ~/lore-data:/data \ lore-serverWindowsdocker stop lore-server; docker rm lore-server docker run -d --name lore-server -p 41337:41337/tcp -p 41337:41337/udp -p 41339:41339 -v ${PWD}/cert.pem:/etc/lore/cert.pem:ro -v ${PWD}/key.pem:/etc/lore/key.pem:ro -v ${PWD}/local.toml:/etc/lore/config/local.toml:ro -v $env:USERPROFILE\lore-data:/data lore-server现在你的数据持久化在挂载的宿主机目录中~/lore-data证书也跨重启保持稳定。local.toml中可以配置的其他一切内容见 Lore Server 配置参考。检查服务器是否健康以下探测方法对两条路径同样适用。在另一个终端中执行curl -i http://127.0.0.1:41339/health_check健康的服务器返回HTTP/1.1 200 OK响应体为空。健康检查的源码语义/health_check由 HTTP 端点提供处理逻辑见 lore-server/src/http/health_check.rs。默认配置下server.http.store_health_check false因此探针只确认进程存活并返回200 OK若将store_health_check开启探针还会检查 store 可用性不可用时返回503 SERVICE_UNAVAILABLE。安装脚本 scripts/install.sh 的演示模式也复用同一端点做就绪轮询curl -fsS http://127.0.0.1:$HTTP_PORT/health_check。零配置默认行为速览理解默认启动的服务器为什么不适合存数据有助于你正确地判断何时需要写配置。当没有任何配置文件时对应 lore-server/config/default.toml 的编译期默认值服务器按以下规则自我收敛为单节点实例并在日志中记录每一项替换TLS 证书公共 QUIC 端点未配置证书时服务器为localhost、127.0.0.1、::1生成自签名证书写入temp/lore-server/endpoint-pid-cert.pem与-key.pem。该证书不受信任、每次重启重新生成、仅限本地开发。本地 store 路径本地 store 未设置path时使用temp/lore-server。该路径固定因此后续运行会重开同一目录并复用上次运行遗留的数据。Presigned URL 功能未配置presigned_url_hmac_key时该功能默认关闭。[!WARNING] 零配置的 store 位于temp/lore-server操作系统可能在重启时清空该目录——其中的所有 fragment 与分支指针都会随之丢失。任何需要跨重启存活的数据都必须在本地 store 上显式设置path。最小持久化配置参考组合模式结合前面的讨论一个持久化单节点 本地覆盖的完整local.toml可组织如下路径按你的环境调整# ./config/local.toml [server.quic.certificate] cert_file /opt/loreserver/certs/cert.pem pkey_file /opt/loreserver/certs/key.pem [immutable_store.local] path /opt/loreserver/store flush_delay_seconds 10 [mutable_store.local] path /opt/loreserver/store flush_delay_seconds 10 [topology] provider noneloreserver --config /opt/loreserver/configlocal.toml覆盖默认值后store 持久化于/opt/loreserver/store跨重启不丢失topology.provider none明确声明单节点模式。[immutable_store]、[mutable_store]、[lock_store]三者默认mode local如需切换到awsS3/DynamoDB、composite、replicated、remote等后端或配置[topology.fixed]多节点拓扑、[server.auth]JWT 认证、[hooks.*]钩子与[telemetry.*]遥测均可在local.toml中按 Lore Server 配置参考 的字段表扩展。仓库还提供了 thin.example.toml只读瘦客户端部署示例与 dev-local.tomlDocker Compose 开发栈、AWS/MinIO 模式示例两份参考配置。相关阅读Install the Lore CLI —— 让lore进入 PATH。Quickstart 快速上手 —— 使用loreCLI 配合本地服务器的完整核心工作流。Lore Server 配置参考 —— 每一个配置字段以及本文略过的多主机、复制、认证与插件后端——通往生产部署的路径。赞分享版本控制后端【免费下载链接】loreLore is a next-generation, open source version control system项目地址https://gitcode.com/gh_mirrors/lore6/lore点击查看免费下载相关推荐使用 Helm Chart 在 Kubernetes 上部署 Pyroscope单二进制与微服务两种模式实战指南使用 Helm Chart 在 Kubernetes 上部署 Pyroscope单二进制与微服务两种模式实战指南 Pyroscope 是一个可水平扩展、高可用可观测性性能剖析后端运维观测AirSim Docker 在 Linux 下的完整部署指南二进制镜像与源码编译两种方案详解AirSim Docker 在 Linux 下的完整部署指南二进制镜像与源码编译两种方案详解 本指南以 AirSim 官方文档 docs/docker_ubu自动驾驶人工智能深度学习强化学习计算机视觉科研Eigent server/ 本地后端深度解析Docker 部署、本地模式数据隔离与持久化实践Eigent server/ 本地后端深度解析Docker 部署、本地模式数据隔离与持久化实践 本文基于 Eigent 仓库中的 server/README_人工智能AI Agent多智能体大模型本地部署MCP 服务桌面应用工作流自动化上一篇Data-Science-For-Beginners 使用指南20 课学习工作流、Jupyter 实操与测验应用本地运行下一篇突破gRPC连接瓶颈grpcurl连接池优化实战指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

STM32接入红外PM2.5传感器:从接线到串口输出完整实战 2026/9/25 5:15:09

STM32接入红外PM2.5传感器:从接线到串口输出完整实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

阅读更多 →
TPFanCtrl2温度日志与CSV数据分析:可视化笔记本温度曲线,找出降频真凶 2026/9/25 5:15:09

TPFanCtrl2温度日志与CSV数据分析:可视化笔记本温度曲线,找出降频真凶

TPFanCtrl2温度日志与CSV数据分析:可视化笔记本温度曲线,找出降频真凶 【免费下载链接】TPFanCtrl2 ThinkPad Fan Control 2 (Dual Fan) for Windows 10 and 11 项目地址: https://gitcode.com/gh_mirrors/tp/TPFanCtrl2 TPFanCtrl2 是一款面向 W…

阅读更多 →
DigitalOcean Managed Agents:智能体工程化落地新范式 2026/9/25 5:15:09

DigitalOcean Managed Agents:智能体工程化落地新范式

1. 这不是又一个“托管服务”噱头,而是智能体落地的临界点DigitalOcean 推出 Managed Agents,这件事我盯着看了整整三天——不是因为它是云厂商的新功能,而是因为它精准踩中了当前智能体开发最痛的三个关节:环境一致性差、调试成本…

阅读更多 →
microduck 远程控制台:用 Hugging Face Space 与 OAuth 驱动的离网机器人 WebRTC 控制页 2026/9/25 5:15:09

microduck 远程控制台:用 Hugging Face Space 与 OAuth 驱动的离网机器人 WebRTC 控制页

机器人嵌入式强化学习人工智能智能硬件计算机视觉音视频 【免费下载链接】microduck A Tiny biped duck robot 🦆 项目地址: https://gitcode.com/gh_mirrors/mi/microduck 点击查看 免费下载 导读 本文围绕 microduck 仓库中 mediad/webclient/space/…

阅读更多 →
ng-zorro-antd 折叠面板隐藏箭头:`nzShowArrow` 用法与实现原理全解析 2026/9/25 5:15:09

ng-zorro-antd 折叠面板隐藏箭头:`nzShowArrow` 用法与实现原理全解析

UI组件前端 【免费下载链接】ng-zorro-antd Angular UI Component Library based on Ant Design 项目地址: https://gitcode.com/gh_mirrors/ng/ng-zorro-antd 点击查看 免费下载 折叠面板(Collapse)的展开箭头图标是用户识别可交互性的重要…

阅读更多 →
Atlas 300V 24G部署YOLO全流程实战:从环境搭建到性能调优 2026/9/25 5:15:02

Atlas 300V 24G部署YOLO全流程实战:从环境搭建到性能调优

说实话,这两个问题几乎是同一个问题:Atlas 300V 24G 就是一张用来做 AI 推理的运算加速卡,而它最典型的落地场景之一,就是把 YOLO 这类目标检测模型真正推到生产环境里跑起来。我手上这块卡用了大半年,从驱动安装、CAN…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉