如何 5 分钟快速部署 Shiori：从安装到保存第一个书签的完整教程
【免费下载链接】shioriSimple bookmark manager built with Go项目地址: https://gitcode.com/gh_mirrors/sh/shiori
Shiori 是一款用 Go 编写的轻量级自托管书签管理工具，以单个二进制文件分发，同时提供命令行和 Web 界面，还能自动解析正文并创建网页离线存档。本教程将带你用 Docker 或二进制文件两种方式快速部署 Shiori，完成登录、保存第一个书签并个性化设置，全程大约 5 分钟。
第 1 步：选择你的 Shiori 部署方式
Shiori 提供了三种安装方式，新手推荐Docker或预编译二进制文件：
| 方式 | 适合人群 | 优点 |
|---|---|---|
| 🐳 Docker 镜像 | 服务器部署 | 一键拉取，环境隔离，升级简单 |
| 📦 预编译二进制文件 | 本地/服务器 | 单文件运行，零依赖 |
| 🛠️ 源码构建 | Go 开发者 | 需要go >= 1.14.1 |
详细说明可查阅官方文档：docs/Installation.md。
第 2 步：一条命令快速启动服务
方式一：Docker 部署（推荐）
docker pull ghcr.io/go-shiori/shiori docker run -d --name shiori -p 8080:8080 -v $(pwd):/shiori ghcr.io/go-shiori/shiori这条命令的作用：
-p 8080:8080：将容器 8080 端口映射到主机；-v $(pwd):/shiori：绑定数据目录，保证书签、数据库和存档不会随容器丢失；-d：后台运行。
仓库中还附带了可用于开发调试的 docker-compose.yaml 和 Dockerfile，可自行参考。
方式二：二进制文件部署
从官方 release 页面下载对应平台的shiori可执行文件并加入PATH，然后直接运行：
shiori server首次启动后，数据默认存放在~/.local/share/shiori（Windows 为%LOCALAPPDATA%/shiori），可通过环境变量SHIORI_DIR自定义位置。
第 3 步：使用默认账号登录 Web 界面
启动后访问http://localhost:8080，你会看到 Shiori 的登录页：
首次使用没有任何账号，直接填入默认凭证即可登录：
- 用户名：
shiori - 密码：
gopher
登录成功后建议尽快到设置页修改密码并创建自己的账号。
第 4 步：保存你的第一个书签
登录后进入首页，点击顶部的+按钮，粘贴一个网址，Shiori 就会：
- 抓取网页标题和封面图；
- 解析正文，自动生成离线存档（断网也能阅读）；
- 以卡片形式展示在书签列表中。
如果你更喜欢命令行，一条命令也能完成保存并打上标签：
shiori add https://example.com -t "教程,工具"各参数的完整说明见 docs/CLI.md。保存后还可以切换阅读模式与存档模式：
第 5 步：个性化你的书签管理器
进入左侧齿轮图标打开设置页，这里可以调整三大类选项：
- Display（显示）：卡片/列表视图切换、启用深色主题；
- Bookmarks（书签）：是否默认创建离线存档、存档是否公开访问；
- Accounts（账号）：添加新账号、修改密码。
部署完成后的进阶建议
- 数据与数据库：默认使用 SQLite 单文件数据库，也支持 PostgreSQL / MySQL，配置见 docs/Configuration.md；
- 数据目录结构：了解存档、缩略图的存储位置见 docs/Storage.md；
- 导入 Pocket 书签：支持从 Pocket 导出文件一键导入已有收藏；
- Web 扩展：浏览器端一键收藏，扩展源码与说明见 docs/API.md。
到这里，你的 Shiori 自托管书签管理器已经上线 🎉——以后遇到值得收藏的文章，粘贴链接即可永久保存，断网也能随时阅读。
【免费下载链接】shioriSimple bookmark manager built with Go项目地址: https://gitcode.com/gh_mirrors/sh/shiori
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
