12
0
0
ZMark 书签管理工具部署文档
2026-08-16
文章摘要
|
1 📌 一、项目概述
ZMark 是 OneNav 作者（xiaoz）全新重构的书签管理系统，支持集中式管理书签，解决跨设备、跨平台、跨浏览器的同步与访问难题。适用于个人书签的批量导入、导出、搜索和分类管理。
2 🛠️ 二、部署环境
| 项目 | 说明 |
|---|---|
| 服务器 | 任意支持 Docker 的 Linux 主机（如 x86_64/ARM 架构） |
| 域名 | zmark.com（按实际替换） |
| 数据目录 | /docker/zmark/data |
| 容器端口 | 3080 |
| 反向代理 | Traefik（已配置 HTTPS） |
3 📄 三、Docker Compose 配置文件
version: '3.8'
services:
zmark:
image: docker.1panel.live/helloz/zmark:latest
container_name: zmark
restart: unless-stopped
networks:
- traefik_public
ports:
- '3080:3080' # 主机端口:容器端口
volumes:
- /docker/zmark/data:/opt/zmark/data
environment:
- TZ=Asia/Shanghai
dns:
- '119.29.29.29'
- '223.5.5.5'
labels: # 没有traefik则注释所有labels
- "traefik.enable=true"
- "traefik.http.routers.zmark.rule=Host(`zmark.com`)"
- "traefik.http.routers.zmark.entrypoints=websecure"
- "traefik.http.routers.zmark.tls=true"
- "traefik.http.routers.zmark.tls.certresolver=letsencrypt"
- "traefik.http.services.zmark.loadbalancer.server.port=3080"
networks:
traefik_public:
external: true
4 🚀 四、部署步骤
4.1 准备工作
bash
创建数据存储目录
mkdir -p /docker/zmark/data
0.1 保存配置文件
将上面的 docker-compose.yml 内容保存到服务器某个目录（如 /docker/zmark/）。
0.2 启动容器
cd /docker/zmark
docker-compose up -d
0.3 验证容器状态
bash
查看容器是否正常运行
docker ps | grep zmark
查看实时日志
docker logs -f zmark
1 🌐 五、访问方式
部署完成后，可通过以下两种方式访问 ZMark：
| 方式 | 地址 | 说明 |
|---|---|---|
| 域名访问（HTTPS）（未部署traefik可跳过） | https://zmark.com | 通过 Traefik 代理，自动 SSL 加密 |
| IP直连（HTTP） | http://服务器IP:3080 | 端口映射直连，不带加密 |
首次访问会进入初始化安装引导界面，按提示设置管理员账号和密码即可。
2 📦 六、核心功能验证
完成初始化后，建议依次验证以下功能是否正常：
| 功能 | 操作路径 | 说明 |
|---|---|---|
| 导入书签 | 后台 → 书签管理 → 导入 | 支持 Chrome/Firefox/Edge 导出的 HTML 文件 |
| 导出书签 | 后台 → 我的链接 → 导出 | 导出为 .html 文件，便于备份 |
| 搜索书签 | 前台首页搜索框 | 支持关键词模糊搜索 |
| 添加书签 | 后台添加 / 前台右键添加 | 支持手动新增链接 |
| 删除书签 | 后台批量删除 / 前台右键删除 | 操作灵活 |
3 🔧 七、常用运维命令
| 操作 | 命令 |
|---|---|
| 停止容器 | docker-compose down |
| 重启容器 | docker-compose restart |
| 更新镜像 | docker-compose pull && docker-compose up -d |
| 查看日志 | docker logs -f zmark |
| 进入容器 | docker exec -it zmark sh |
4 💾 八、数据备份建议
ZMarl 的数据存储在挂载目录 /docker/zmark/data 中，建议定期备份该目录。
bash
示例备份命令（可写入 crontab 定时执行）
tar -czf /backup/zmark_data_$(date +%Y%m%d).tar.gz /volume2/docker/zmark/data
1 ❓ 九、常见问题处理
| 问题 | 可能原因 | 解决方法 |
|---|---|---|
| 容器无法启动 | 端口被占用 | 检查 3080 端口是否被其他服务占用，修改主机端口 |
| 拉取镜像失败 | 镜像源不可用 | 将 docker.1panel.live/helloz/zmark 换成 helloxz/zmark 重试 |
| 页面无法访问 | Traefik 配置问题 | 尝试通过 IP:3080 直连，确认容器是否正常运行 |
| 数据丢失 | 数据目录未正确挂载 | 检查 volumes 路径是否正确，尤其是冒号左边的本地路径 |
2 📚 十、参考资料
-
ZMarl 项目官网：[待补充]
-
Docker 镜像源：
docker.1panel.live/helloz/zmark -
Traefik 反向代理：已配置
zmark.lipei.online路由
ZMark 书签管理工具部署文档
/archives/zmark-shu-qian-guan-li-gong-ju-bu-shu-wen-dang