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

环境准备：如何搭建Slink开发环境？

三步掌握项目获取与依赖安装

1. 获取项目代码
   首先克隆官方仓库到本地：

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

2. 安装后端依赖
   项目后端基于PHP开发，使用Composer管理依赖：

   cd services/api
   composer install
   

3. 安装前端依赖
   客户端采用Svelte框架，使用Yarn安装依赖：

   cd ../../services/client
   yarn install
   

核心目录重要性排序（按开发频率）

目录路径	功能描述	开发频率
services/client/src	前端源代码	★★★★★
services/api/src	后端业务逻辑	★★★★☆
docker/	容器化配置	★★★☆☆
services/api/config	应用配置文件	★★☆☆☆
tests/	测试代码	★★☆☆☆

核心组件解析：Slink的架构是怎样的？

前后端分离的核心架构

Slink采用现代化的前后端分离架构：

• 后端服务：基于Symfony框架构建的RESTful API，处理业务逻辑与数据持久化
• 前端应用：使用Svelte构建的单页应用，提供直观的用户界面
• 数据存储：支持本地文件系统和云存储两种模式
• 容器化部署：通过Docker Compose实现服务编排

图1：Slink的图片详情页，展示了图片预览、尺寸调整和分享功能

关键技术栈速览

• 后端：PHP 8.2+, Symfony 6, Doctrine ORM
• 前端：Svelte 3, TypeScript, Tailwind CSS
• 数据库：PostgreSQL (默认)
• 缓存：Redis
• 容器化：Docker, Docker Compose

快速上手：如何启动Slink服务？

两种启动方式对比

启动方式	适用场景	操作命令
开发模式	代码调试、功能开发	pnpm run dev (前端) symfony serve (后端)
Docker模式	生产环境、快速部署	docker-compose up -d

开发模式启动步骤

1. 启动后端服务：

   cd services/api
   symfony serve --port=8000
   

2. 启动前端开发服务器：

   cd services/client
   pnpm run dev -- --port=3000
   

3. 访问应用：
   打开浏览器访问 http://localhost:3000 即可使用Slink

Docker模式启动步骤

1. 构建并启动容器：

   docker-compose up -d --build
   

2. 初始化数据库：

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

3. 访问应用：
   打开浏览器访问 http://localhost (默认端口)

图2：Slink的上传历史页面，展示图片管理功能

个性化配置：如何定制Slink服务？

配置优先级规则 ⚙️

Slink的配置加载遵循以下优先级（从高到低）：

1. 环境变量：运行时注入的环境变量
2. 环境配置文件：如 config/production.yaml
3. 默认配置：框架自带的默认配置

核心配置项详解

配置项名称	默认值	修改建议
server.port	8000	生产环境建议使用80/443
storage.provider	local	大规模部署建议使用s3
storage.path	/var/data	确保目录有读写权限
database.url	sqlite:///%kernel.project_dir%/var/data.db	生产环境建议使用PostgreSQL

新手避坑指南 🔧

1. 权限问题：
   错误：Permission denied 写入存储目录
   解决：执行 chmod -R 775 services/api/var 并确保目录所有者正确

2. 端口冲突：
   错误：Address already in use
   解决：修改配置文件中的端口号或停止占用端口的服务

3. 数据库连接失败：
   错误：Connection refused
   解决：检查数据库服务是否运行，连接参数是否正确

4. 依赖安装失败：
   错误：composer install 失败
   解决：确保PHP版本≥8.2，且安装了必要的扩展

图3：Slink的图片分享界面，支持多种格式和尺寸选择

总结

Slink作为自托管图片分享服务，通过模块化的架构设计和灵活的配置选项，为个人和团队提供了安全可控的图片管理解决方案。无论是本地开发还是生产部署，都能通过简单的命令快速上手。通过本文介绍的环境准备、组件解析、启动流程和配置技巧，您已经具备了使用和定制Slink的基础知识。

如需进一步深入，可以探索项目的插件系统和API扩展能力，打造更符合个人需求的图片分享平台。