Slink：零门槛自建图片分享服务全攻略

Slink 是一款开源的自托管（Self-hosted）图片分享服务，让你轻松搭建属于自己的图片存储与分享平台。无需复杂配置，3 步即可完成部署，支持图片上传、裁剪、格式转换等核心功能，数据完全掌握在自己手中，告别第三方平台依赖。

一、快速上手：3 步搭建个人图片服务器

1.1 零基础环境准备

在开始前，请确保你的服务器已安装 Docker 和 Docker Compose。这两个工具将帮助我们快速部署 Slink，无需手动配置复杂的运行环境。

1.2 一键获取项目代码

打开终端，执行以下命令克隆 Slink 项目代码：

git clone https://gitcode.com/gh_mirrors/sl/slink
cd slink

1.3 启动服务（🚀 30 秒完成）

在项目根目录下，运行 Docker Compose 命令启动服务：

docker-compose up -d

等待命令执行完成后，打开浏览器访问 http://localhost:5173，即可看到 Slink 的上传界面。

二、核心组件解析：认识 Slink 的 4 大功能模块

2.1 直观的图片上传面板

Slink 提供简洁的拖拽上传区域，支持 PNG、JPG、GIF 等多种格式。你可以直接将图片拖入上传框，或使用快捷键 Cmd + V 粘贴剪贴板中的图片。

2.2 强大的图片管理中心

上传后的图片会显示在「上传历史」页面，你可以通过标签筛选、网格/列表视图切换等方式快速找到需要的图片。

2.3 便捷的图片编辑工具

点击任意图片进入详情页，你可以调整图片尺寸、添加描述、设置标签。尺寸调整时会自动锁定宽高比，确保图片不变形。

2.4 灵活的分享功能

每个图片都生成唯一的分享链接，支持直接复制或选择不同格式（如 PNG、WebP）分享。点击「Copy」按钮即可将链接复制到剪贴板。

三、个性化配置：5 个必知的自定义项

3.1 自定义存储路径设置

默认情况下，图片存储在容器内部。若需将图片保存到宿主机指定目录，修改 docker-compose.yaml 文件：

services:
  api:
    volumes:
      - ./my-images:/app/var/data  # 左侧替换为你的本地路径

3.2 调整服务端口号

若默认端口 5173 已被占用，修改 docker-compose.yaml 中的端口映射：

services:
  client:
    ports:
      - "8080:80"  # 将 8080 替换为你需要的端口

3.3 配置环境变量优先级

Slink 支持通过环境变量覆盖配置文件。例如设置数据库连接：

# 在启动命令前添加环境变量
DB_HOST=mysql DB_PORT=3306 docker-compose up -d

环境变量优先级高于 config/ 目录下的配置文件。

3.4 启用 HTTPS 安全访问

编辑 docker/config/caddy/Caddyfile，添加 HTTPS 配置：

your-domain.com {
  reverse_proxy api:80
  tls [e-mail]
}

3.5 设置用户认证

修改 services/api/config/security.yaml，启用基本认证：

security:
  enable_authentication: true
  users:
    - username: admin
      password: your-secure-password  # 建议使用加密后的密码

四、常见问题排查

4.1 服务启动后无法访问

• 检查 Docker 容器是否正常运行：docker-compose ps
• 确认端口未被占用：netstat -tuln | grep 5173
• 查看容器日志：docker-compose logs -f

4.2 图片上传后不显示

• 检查存储目录权限是否正确，确保容器有读写权限
• 查看 API 服务日志，是否有报错信息

4.3 分享链接无法访问

• 确认服务器防火墙已开放对应端口
• 若使用域名访问，检查 DNS 解析是否正确

通过以上步骤，你已掌握 Slink 的基本使用和配置方法。开始搭建你的个人图片分享平台，享受数据自主掌控的乐趣吧！