Slink：轻量级自托管图片分享服务全流程部署与优化指南

构建运行环境

1.1 环境依赖检查

在开始部署前，请确保系统已安装以下工具：

• Git（版本≥2.20.0）
• Docker 与 Docker Compose（Docker 版本≥20.10.0，Compose 版本≥v2.0.0）
• Node.js（版本≥16.0.0，仅本地开发需要）

验证命令：

git --version
docker --version && docker compose version
node --version # 可选，本地开发时检查

1.2 项目资源获取

通过 Git 克隆项目代码库：

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

1.3 核心模块解析

项目采用前后端分离架构，主要模块功能如下：

• docker/：容器化部署配置，包含开发/生产环境的 Docker Compose 配置文件
• services/api/：后端服务核心代码，基于 Symfony 框架构建的 RESTful API
• services/client/：前端单页应用，采用 Svelte 框架开发的响应式界面
• services/client/static/：前端静态资源，包含图标和截图等资源文件
• screens/：项目功能演示截图，可用于文档和展示

图1：Slink 图片上传界面，支持拖放操作和多种格式

部署应用服务

2.1 多环境启动方案

Slink 提供三种部署模式，可根据实际场景选择：

2.1.1 开发环境（本地调试）

# 启动开发环境容器
docker compose -f docker-compose.dev.yaml up -d

# 安装后端依赖
docker compose -f docker-compose.dev.yaml exec api composer install

# 安装前端依赖并构建
docker compose -f docker-compose.dev.yaml exec client yarn install
docker compose -f docker-compose.dev.yaml exec client yarn dev

访问地址：http://localhost:5173（前端）、http://localhost:8000（API）

2.1.2 生产环境（服务器部署）

# 构建生产镜像
docker compose build

# 启动服务（后台运行）
docker compose up -d

首次启动需执行数据库迁移：

docker compose exec api bin/console doctrine:migrations:migrate

2.1.3 演示环境（快速体验）

docker compose -f docker-compose.demo.yaml up -d

特点：包含测试数据，自动填充示例图片，适合功能评估

2.2 环境适配指南

根据部署环境需求，调整对应配置文件：

2.2.1 开发环境配置

修改 [docker/config/runtime/develop.conf]：

# 推荐开发环境配置
DEBUG=true
LOG_LEVEL=debug
MAX_UPLOAD_SIZE=50M

2.2.2 生产环境配置

修改 [docker/config/runtime/production.conf]：

# 推荐生产环境配置
DEBUG=false
LOG_LEVEL=info
MAX_UPLOAD_SIZE=20M 🔧
# 风险提示：增大上传限制可能导致存储占用激增和性能问题

2.2.3 数据库配置

生产环境建议使用外部数据库，修改 [docker-compose.yaml]：

services:
  api:
    environment:
      DATABASE_URL: "postgresql://user:password@external-db:5432/slink"

图2：Slink 上传历史管理界面，支持标签筛选和批量操作

系统调优策略

3.1 存储配置优化

Slink 支持本地存储和云存储两种模式，根据需求选择：

3.1.1 本地存储配置

修改 [services/api/config/settings.yaml]：

storage:
  provider: 'local'
  path: '/var/data/slink' 🔧
  max_size: '10G' # 总存储容量限制

风险提示：确保存储路径有足够空间，建议定期备份数据

3.1.2 云存储配置（以 S3 为例）

storage:
  provider: 's3'
  endpoint: 'https://s3.amazonaws.com'
  bucket: 'your-bucket-name'
  access_key: 'your-access-key'
  secret_key: 'your-secret-key'

3.2 性能优化建议

3.2.1 缓存配置

启用 Redis 缓存提升性能，修改 [services/api/config/packages/cache.yaml]：

framework:
  cache:
    app: cache.adapter.redis
    default_redis_provider: 'redis://redis:6379'

3.2.2 图片处理优化

调整图片处理参数，修改 [services/api/config/services/image.yaml]：

parameters:
  image.quality: 85 # 推荐值，平衡质量与文件大小
  image.max_dimension: 4096 # 限制最大尺寸，防止超大图片处理

3.3 安全加固措施

3.3.1 CORS 配置

修改 [services/api/config/packages/nelmio_cors.yaml]，限制跨域访问：

nelmio_cors:
  defaults:
    allow_origin: ['https://your-domain.com']
    allow_methods: ['GET', 'POST', 'PUT', 'DELETE']
    allow_headers: ['Content-Type', 'Authorization']

3.3.2 访问控制

通过 [services/api/config/security.yaml] 配置用户权限：

security:
  access_control:
    - { path: ^/api/admin, roles: ROLE_ADMIN }
    - { path: ^/api/images, roles: ROLE_USER }

图3：Slink 图片编辑界面，支持尺寸调整和格式转换

日常维护与故障排除

4.1 日志查看

# 查看 API 服务日志
docker compose logs -f api

# 查看前端服务日志
docker compose logs -f client

4.2 数据备份

# 数据库备份
docker compose exec api bin/console doctrine:database:dump > backup_$(date +%Y%m%d).sql

# 图片数据备份（本地存储时）
tar -czf data_backup_$(date +%Y%m%d).tar.gz var/data/

4.3 常见问题解决

• 上传失败：检查存储路径权限和磁盘空间，确认 MAX_UPLOAD_SIZE 配置
• 访问缓慢：检查 Redis 缓存是否启用，优化数据库查询
• 图片处理错误：确认 ImageMagick 已正确安装，检查图片格式是否支持

通过以上步骤，您可以完成 Slink 服务的部署与优化。该服务特别适合需要私有图片管理解决方案的团队或个人使用，提供安全可控的图片存储与分享功能。