Shaarli 与 Docker：容器化部署的完整解决方案

方拓行Sandra

361人浏览 · 2026-01-28 01:46:36

方拓行Sandra · 2026-01-28 01:46:36 发布

Shaarli 与 Docker：容器化部署的完整解决方案

【免费下载链接】Shaarli 项目地址: https://gitcode.com/gh_mirrors/sh/Shaarli

Shaarli 是一款轻量级、开源的书签管理工具，让你轻松收集、分类和分享网络资源。结合 Docker 容器化技术，你可以快速部署一个稳定、安全的 Shaarli 服务，无需担心复杂的环境配置。本文将带你一步步完成 Shaarli 的 Docker 化部署，从环境准备到启动服务，让你轻松拥有属于自己的书签管理系统。

🐳 为什么选择 Docker 部署 Shaarli？

Docker 容器化部署为 Shaarli 带来了诸多优势：

环境一致性：无论在哪台机器上，Docker 容器都能提供相同的运行环境，避免了 "在我电脑上能运行" 的问题
快速部署：一条命令即可启动完整的 Shaarli 服务，省去繁琐的依赖安装过程
隔离性好：容器化运行确保 Shaarli 不会影响系统其他组件，也避免系统变动影响 Shaarli
易于升级：通过容器镜像版本控制，轻松实现 Shaarli 的升级和回滚

项目中提供了完整的 Docker 支持文件，包括 Dockerfile 和 docker-compose.yml，为容器化部署提供了便利。

📋 准备工作：Docker 环境搭建

在开始部署前，请确保你的系统已安装 Docker 和 Docker Compose：

安装 Docker：根据你的操作系统，参考 Docker 官方文档进行安装
安装 Docker Compose：通常与 Docker 一起安装，也可单独安装

验证安装是否成功：

docker --version
docker-compose --version

🚀 快速部署：使用 Docker Compose 一键启动

Shaarli 项目提供了便捷的 docker-compose 配置，让部署变得异常简单：

首先克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/sh/Shaarli
cd Shaarli

使用 docker-compose 启动服务：

docker-compose up -d

这条命令会自动拉取 Shaarli 镜像并启动服务，默认情况下，Shaarli 会在后台运行并监听 80 端口。

🔧 详细配置：自定义你的 Shaarli 服务

如果你需要自定义配置，可以修改 docker-compose.yml 文件：

version: '3'
services:
  shaarli:
    image: ghcr.io/shaarli/shaarli:latest
    volumes:
      - ./data:/var/www/shaarli/data
    ports:
      - "8080:80"  # 可以修改端口映射
    environment:
      - TZ=Asia/Shanghai  # 设置时区

修改后，使用 docker-compose up -d 重新启动服务使配置生效。

🔖 首次使用：完成 Shaarli 初始化

服务启动后，访问 http://localhost:80（或你配置的端口），会看到 Shaarli 的安装页面：

在安装页面，你需要设置：

用户名和密码
Shaarli 标题
语言和时区
是否启用 REST API

填写完成后点击 "Install" 按钮，稍等片刻即可完成初始化。

📁 数据持久化：保护你的书签数据

为了确保书签数据不会因容器重启而丢失，Shaarli 的 Docker 配置默认启用了数据卷挂载：

volumes:
  - ./data:/var/www/shaarli/data

这会将容器内的 /var/www/shaarli/data 目录映射到主机的 ./data 目录，所有书签数据都会保存在这里。

🔄 升级与维护：保持 Shaarli 最新

当有新版本 Shaarli 发布时，你可以通过以下步骤升级：

拉取最新镜像：

docker-compose pull

重启服务：

docker-compose up -d

Docker 会自动处理升级过程，你的数据会安全地保存在数据卷中。

🧩 高级配置：使用 Traefik 实现反向代理

项目的 docker-compose.yml 中还提供了 Traefik 反向代理的配置示例，可用于实现 HTTPS、负载均衡等高级功能：

services:
  traefik:
    image: traefik:1.7-alpine
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./traefik.toml:/etc/traefik/traefik.toml
      - ./acme:/etc/traefik/acme