🌏 Obsidian Remote 中文版

为 Obsidian Remote Docker 镜像添加中文字体支持，解决中文显示乱码问题

📖 简介

Obsidian Remote 是一个基于 Docker 的 Obsidian 仓库远程访问解决方案。

问题： 原版镜像 (ghcr.io/sytone/obsidian-remote) 缺少中文字体，导致中文笔记显示为乱码（□□□）。

解决： 本镜像在原镜像基础上添加了常用中文字体包，完美支持中文显示。

✨ 特性

✅ 完美支持中文显示
✅ 支持繁体中文
✅ 支持日文、韩文 (CJK)
✅ 基于官方 Obsidian Remote
✅ 轻量级（仅增加 ~50MB）
✅ 即开即用，无需额外配置

🚀 快速开始

方法 1：使用构建好的镜像

docker pull ghcr.io/rusmass/obsidian-remote-cn:latest

docker run -d \
  --name obsidian-remote \
  -p 8080:8080 \
  -v /path/to/your/vault:/vault \
  ghcr.io/rusmass/obsidian-remote-cn:latest

方法 2：自行构建

git clone https://github.com/rusmass/obsidian-remote-cn.git
cd obsidian-remote-cn
docker build -t obsidian-remote-cn:latest .

docker run -d \
  --name obsidian-remote \
  -p 8080:8080 \
  -v /path/to/your/vault:/vault \
  obsidian-remote-cn:latest

📦 包含的字体

字体包	说明
`fonts-wqy-zenhei`	文泉驿正黑 - 常用简体中文
`fonts-wqy-microhei`	文泉驿微米黑 - 现代风格简体
`fonts-noto-cjk`	Google Noto CJK - 覆盖简繁日韩
`fontconfig`	字体配置工具

🔧 配置说明

环境变量

变量	默认值	说明
`PASSWORD`	无	访问密码（建议设置）
`PORT`	`8080`	服务端口

端口映射

默认端口：8080
可自定义：-p 3000:8080

数据卷挂载

-v /path/to/your/vault:/vault

将你的 Obsidian 仓库挂载到 /vault 目录。

🌐 访问

构建完成后，在浏览器访问：

http://localhost:8080

或（如果是 NAS/服务器）：

http://你的 IP:8080

📸 截图

中文显示效果

中文显示示例

中文笔记正常显示，无乱码

🔨 构建细节

Dockerfile

FROM ghcr.io/sytone/obsidian-remote:latest

USER root

RUN apt-get update && apt-get install -y \
    fonts-wqy-zenhei \
    fonts-wqy-microhei \
    fonts-noto-cjk \
    fontconfig \
    && rm -rf /var/lib/apt/lists/*

RUN fc-cache -fv

构建命令

docker build -t obsidian-remote-cn:latest .

导出镜像备份

docker save -o obsidian-remote-cn.tar obsidian-remote-cn:latest

压缩备份（可选）

gzip obsidian-remote-cn.tar
# 生成 obsidian-remote-cn.tar.gz

❓ 常见问题

Q: 为什么中文还是乱码？

清除浏览器缓存后重试
检查是否正确挂载了 vault 目录
确认笔记文件本身是 UTF-8 编码

Q: 可以自定义字体吗？

A: 可以，修改 Dockerfile 中的字体包，重新构建即可。

Q: 支持移动端吗？

A: 支持，使用手机浏览器访问即可。

Q: 数据安全吗？

A: 数据完全存储在本地，不会上传到任何服务器。

Q: 原版镜像和新版有什么区别？

A: 仅增加了中文字体包，其他功能完全一致。

📋 一键构建脚本

项目包含 build.sh 脚本，一键完成构建和运行：

chmod +x build.sh
./build.sh

🙏 致谢

Obsidian - 强大的知识库工具
sytone/obsidian-remote - 原版镜像作者

📄 许可证

MIT License

🔗 链接

Made with ❤️ for Obsidian Chinese Users

最后更新: 2026-03-09

Remote Cn