shlink可在linux直接运行，但必须满足php 8.4+、composer及mysql/postgresql/sqlite之一；docker部署最简捷，源码部署需注意扩展启用、权限配置与web服务器路由设置。
Shlink 在 Linux 上能直接跑，但必须满足 PHP 8.4+、Composer 和一个支持的数据库（MySQL/PostgreSQL/SQLite），缺一不可。Docker 部署最省事，源码部署更可控，但容易卡在扩展或权限上。
确认 PHP 环境是否达标
Shlink 不兼容 PHP 8.3 及更早版本，php -v 输出必须显示 8.4.x。常见坑点：
-
mbstring、xml、curl、pdo_mysql（或对应数据库扩展）必须启用，php -m里要能看到 - 如果用 Ubuntu/Debian，别只装
php元包，得单独装扩展：sudo apt install php-mbstring php-xml php-curl php-sqlite3 php-pdo php-mysql - SELinux 或 AppArmor 可能拦截 Web 服务器读写
/data目录，临时关掉测试：sudo setenforce 0
Docker 部署：5 分钟跑起来
这是最推荐的方式，避免环境冲突。注意端口、数据卷和时区三个硬性配置：
Linux Ai Server
下载
Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI，零 GUI 开销。
- 运行命令里必须映射
-p 8080:8080，否则访问不到；若想用 80 端口，宿主机不能有其他服务占着 -
-v /opt/shlink-data:/data是持久化关键，路径要提前mkdir -p /opt/shlink-data并chown 1001:1001 /opt/shlink-data - 加
-e TZ=Asia/Shanghai防止统计时间错乱，尤其涉及过期时间或日志分析时 - 启动后等 20 秒再执行：
docker exec -it shlink shlink api-key:generate，否则会报Connection refused
docker run -d \ --name shlink \ -p 8080:8080 \ -v /opt/shlink-data:/data \ -e TZ=Asia/Shanghai \ --restart unless-stopped \ shlinkio/shlink:latest
源码安装：适合需要自定义或调试的场景
不建议新手直接源码装，但如果你要改路由逻辑、加中间件或对接内部认证系统，就得走这条路：
- 克隆后别直接
composer install，先改.env：填好DB_DRIVER、DB_HOST、DB_NAME等，SQLite 可跳过 host/port -
vendor/bin/shlink-installer install会自动建表、生成 config，但失败时不会提示具体哪步错了，得看var/log/prod.log - Web 服务器要指向
public/目录，Nginx 示例中必须包含try_files $uri /index.php?$query_string;，漏了就 404 - CLI 命令如
bin/cli short-url:list必须在项目根目录下执行，否则报Could not open input file: bin/cli
导入旧短链数据时的格式陷阱
CSV 导入看着简单，实际字段顺序和空值处理极敏感：
- 首行必须是纯英文标题：
long_url,custom_slug,valid_since,valid_until,max_visits,tags，多一个空格或中文冒号都失败 -
long_url列绝对不能为空，https://必须写全，example.com会被拒绝 - 时间字段要用 ISO 8601 格式：
2026-04-20T00:00:00+08:00，2026/04/20或2026-04-20 00:00全报错 - 标签用英文逗号分隔：
marketing,api，不是 JSON 数组也不是分号 - 执行导入前先用小文件测：
php bin/cli import:short-urls /tmp/test.csv，成功后再换全量
真正麻烦的从来不是安装，而是数据库选型和反向代理配置——比如用 Nginx 做 HTTPS 终结时，X-Forwarded-Proto 没传，所有重定向都会变成 http://；又比如选 SQLite 后并发稍高就锁表，这些细节不踩一遍根本意识不到。
