Slink 自托管图片分享服务完全指南

一、核心组件解析

【组件概览】核心目录功能矩阵

路径	功能描述	使用场景
docker/	Docker配置文件与容器编排脚本	容器化部署、开发环境搭建
services/api/	后端API服务代码	业务逻辑处理、数据库交互
services/client/	前端单页应用	用户界面展示、交互操作
services/api/config/	应用配置文件	环境变量管理、服务参数调整
screens/	应用界面截图	文档说明、功能演示
services/client/static/screenshots/	客户端功能截图	用户手册、宣传材料

【功能解析】核心服务组件

Slink系统由三大核心服务构成：

1. API服务 (services/api/)

   • 基于Symfony框架构建的后端服务
   • 处理图片上传、存储、转换等核心业务逻辑
   • 提供RESTful接口供前端调用

2. Web客户端 (services/client/)

   • 基于Svelte构建的单页应用
   • 提供直观的用户界面和交互体验
   • 支持图片管理、分享和编辑功能

3. 容器化服务 (docker/)

   • 提供多环境部署配置
   • 包含Caddy服务器、数据库等依赖组件
   • 支持开发、测试和生产环境隔离

二、环境配置指南

【基础配置】环境变量设置

Slink支持通过环境变量灵活配置系统行为，核心环境变量包括：

• 数据库配置

  • DATABASE_URL: 数据库连接字符串（默认值：postgresql://user:password@database:5432/slink）
  • DATABASE_PORT: 数据库端口（默认值：5432）

• 服务器配置

  • PORT: API服务端口（默认值：8000）
  • APP_ENV: 运行环境（默认值：dev，可选值：dev/prod/test）

• 存储配置

  • STORAGE_PROVIDER: 存储提供者（默认值：local，可选值：local/s3）
  • STORAGE_PATH: 本地存储路径（默认值：/var/data）

【配置继承】环境配置文件覆盖规则

Slink采用配置文件继承机制，配置优先级从高到低为：

1. 环境变量 > 2. 环境特定配置 > 3. 默认配置

📌 配置文件继承示例：

// config/default.json (基础配置)
{
  "server": {
    "port": 8000,
    "timeout": 30
  },
  "database": {
    "host": "localhost",
    "port": 5432
  }
}

// config/production.json (生产环境覆盖)
{
  "server": {
    "port": 80,
    "timeout": 60
  }
}

💡 提示：生产环境中建议通过环境变量设置敏感信息（如数据库密码），避免直接写入配置文件。配置文件应添加到版本控制忽略列表中。

【依赖关系】核心配置项关联说明

部分配置项存在依赖关系，需特别注意：

1. 数据库与服务器端口

   • database.port与server.port无直接关联，但需确保两者不冲突
   • 若使用Docker部署，需同步配置容器端口映射

2. 存储配置链

   • 当STORAGE_PROVIDER=s3时，需同时配置AWS_ACCESS_KEY和AWS_SECRET_KEY
   • 本地存储模式下，STORAGE_PATH需确保有读写权限

三、运行流程详解

【启动方案】多环境启动方式对比

启动方式	适用场景	操作步骤
开发环境	本地开发调试	1. git clone https://gitcode.com/gh_mirrors/sl/slink 2. cd slink 3. docker-compose -f docker-compose.dev.yaml up
生产环境	服务器部署	1. 配置.env.prod文件 2. docker-compose up -d 3. docker-compose exec api php bin/console doctrine:migrations:migrate
单机测试	功能验证	1. cd services/api 2. composer install 3. symfony serve

🔧 开发环境启动步骤：

# 克隆代码仓库
git clone https://gitcode.com/gh_mirrors/sl/slink

# 进入项目目录
cd slink

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

# 安装依赖
docker-compose exec api composer install

# 执行数据库迁移
docker-compose exec api php bin/console doctrine:migrations:migrate

# 启动前端开发服务器
cd services/client
yarn install
yarn dev

【操作流程】图片上传与管理

1. 上传图片

   • 通过Web界面拖放图片至上传区域
   • 或使用API调用：POST /api/images
   • 支持批量上传和格式验证

2. 图片处理

   • 调整尺寸：通过界面或API参数设置宽高
   • 格式转换：支持JPEG、PNG、WebP等格式
   • 添加标签：通过标签系统分类管理

3. 分享与管理

   • 生成分享链接：点击"Copy"按钮复制URL
   • 管理上传历史：在"Upload History"页面查看所有上传

四、故障排查与优化

【问题解决】常见启动故障排查矩阵

错误现象	可能原因	解决方案
数据库连接失败	数据库服务未启动	检查PostgreSQL容器状态：docker-compose ps
API服务500错误	依赖未安装	执行composer install安装依赖
前端页面空白	前端资源未构建	运行yarn build构建静态资源
文件上传失败	存储路径权限不足	调整STORAGE_PATH目录权限为755
端口冲突	端口被占用	修改.env文件中的PORT配置

【性能优化】生产环境配置建议

1. 资源限制

   • 设置容器资源限制：

   # docker-compose.yaml
   services:
     api:
       deploy:
         resources:
           limits:
             cpus: '1'
             memory: 1G
   

2. 日志管理

   • 配置日志轮转：

   # /etc/logrotate.d/slink
   /var/log/slink/*.log {
     daily
     rotate 7
     compress
     missingok
   }
   

3. 缓存策略

   • 启用Redis缓存：

   // config/production.json
   {
     "cache": {
       "provider": "redis",
       "dsn": "redis://redis:6379"
     }
   }
   

💡 提示：生产环境建议使用HTTPS加密传输，可通过Caddy自动配置Let's Encrypt证书，修改docker/config/caddy/Caddyfile即可启用。

通过以上配置和优化，Slink可以稳定运行在各种环境中，提供高效的自托管图片分享服务。无论是个人使用还是团队协作，Slink的灵活性和可扩展性都能满足不同场景的需求。