suziwen/dragon

小书匠天马飞天版 Docker 镜像

镜像概述

小书匠天马飞天版是一款可自行部署的知识管理系统，其名称"天马飞天"象征着强大的功能扩展能力。该版本在https://hub.docker.com/repository/docker/suziwen/pegasus%E5%9F%BA%E7%A1%80%E4%B8%8A%E5%8F%91%E5%B1%95%E8%80%8C%E6%9D%A5%EF%BC%8C%E4%B8%93%E6%B3%A8%E4%BA%8E%E6%8F%90%E4%BE%9B%E6%9B%B4%E4%B8%B0%E5%AF%8C%E7%9A%84%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%AB%AF%E6%96%87%E7%AB%A0%E7%AE%A1%E7%90%86%E5%8A%9F%E8%83%BD%E3%80%82

核心功能与特性

与天马版的核心差异

• 增强的服务器文章管理：提供服务器端全文搜索（基于Lucene）功能
• 功能扩展方向：未来将持续开发更多高级文章管理接口
• 性能需求：由于功能增强，对服务器性能要求略高于天马版

共同特性

• 支持多端同步功能
• 数据文件可通过映射持久化存储
• 支持版本间平滑切换（需保证数据文件路径一致）

使用场景与适用范围

• 推荐使用场景：需要将服务器作为个人数据中心，且对文章管理有更高需求（如全文搜索）的用户
• 不推荐场景：仅需基础多端同步功能，或服务器硬件资源有限的用户（建议选择天马版）
• 版本切换说明：不同版本可自由切换（需保证数据文件路径一致），切换前建议备份数据以防损坏

配置要求

硬件配置

• 最低配置：1 CPU，512MB 内存
• 建议配置：1 CPU，1GB 内存

系统环境

• 推荐操作系统：Ubuntu 20.04 LTS x64（已在该环境测试通过）
• 注意：部分云厂商的操作系统镜像可能因Docker魔改限制需要更高配置，可尝试切换操作系统镜像解决

使用方法

基本运行命令

bash
docker run -d --name story-writer -p 80:80 docker.xuanyuan.run/suziwen/dragon:latest

其他通用参数可参考https://hub.docker.com/repository/docker/suziwen/pegasus%E6%96%87%E6%A1%A3

索引文件持久化

索引文件默认路径：

/opt/couchdb-lucene/indexes

如需将索引文件映射到宿主机，添加以下参数：

bash
-v /home/user/lucene/indexes:/opt/couchdb-lucene/indexes

与小书匠客户端集成

使用内置CouchDB数据库时，需注意：

• 正确地址格式：使用80端口访问数据库，而非CouchDB默认的5984端口
• 示例地址：

  http://ip:80/data/user_1  # 正确地址
  http://ip:5984/user_1     # 错误地址（请勿使用）
  

• 仅通过80端口访问才能使用服务器端全文搜索功能

数据管理建议

• 务必将数据文件映射到宿主机进行持久化存储
• 版本切换前建议备份数据文件
• 定期检查索引文件完整性，确保搜索功能正常运行