基于PHP + PostgreSQL构建的、为创业团队、电商平台及中小型企业量身打造的下一代短链接SaaS解决方案。
在线Demo | 项目官网
Demo站后台地址：https://zuz.asia/admin
Demo站后台token：admintoken
Demo站会定时清空数据，请勿长期使用，需要短链接服务请访问官网
*Release仅用于版本发布，使用时请Fork本仓库或点击一键部署。
*由于Vercel与PHP存在部分冲突，故依赖Composer的功能如二维码生成及活码管理退出上线。
*当前版本为正式版v1.1.9，可直接更新
首先创建数据库和用户，并授予必要的权限（请将<数据库名>等占位符替换为实际值，例如zuz_db）：
-- 创建数据库
CREATE DATABASE <数据库名>;
-- 创建用户
CREATE USER <数据库用户名> WITH PASSWORD '<数据库密码>';
-- 授予数据库权限
GRANT ALL PRIVILEGES ON DATABASE <数据库名> TO <数据库用户名>;
-- 连接到数据库
\c <数据库名>
-- 授予 Schema 权限（重要！）
ALTER SCHEMA public OWNER TO <数据库用户名>;
GRANT ALL ON SCHEMA public TO <数据库用户名>;提示：执行后无需重复连接数据库。
编辑 Apache 配置文件（通常在 /etc/apache2/sites-available/ 或 /etc/httpd/conf.d/）：
<VirtualHost *:80>
# 强制跳转到 HTTPS
Redirect permanent / https://<你的域名>/
</VirtualHost>
<VirtualHost *:443>
# 运行目录
DocumentRoot /var/www/<站点根目录>/api
# 环境变量（建议使用英文注释以避免解析问题）
SetEnv DATABASE_URL "postgresql://<你的用户名>:<你的密码>@<数据库地址>:<端口>/<数据库名>"
SetEnv ADMIN_TOKEN "<你的管理员令牌>"
</VirtualHost>提示：为HTTPS配置SSL证书（如使用Let's Encrypt）以确保安全。
# 启用 rewrite 模块（用于伪静态）
sudo a2enmod rewrite
# 启用 env 模块（用于环境变量）
sudo a2enmod env
# 重启 Apache
sudo systemctl restart apache2# 进入项目目录
cd /var/www/<网站根目录>
# 设置所有者为 Apache 用户（根据系统不同可能是 www-data 或 apache）
sudo chown -R www-data:www-data .
# 设置适当的权限（生产环境可细化：PHP文件644，目录755）
sudo chmod -R 755 .运行数据库迁移必须保持这些：
- 确保 PostgreSQL 服务正在运行
- 确保 PHP 已安装
pdo_pgsql扩展
项目的PostgreSQL连接符和Admin登录Token采用环境变量存储，这样可以做到几乎绝对的安全性。 如果需要部署到个人VPS上，可参考上方内容，如不使用Apache，必须手动导入下方内容到环境变量。
DATABASE_URL="postgresql://<你的用户名>:<你的密码>@<数据库地址>:<端口>/<数据库名>"
ADMIN_TOKEN="你的Token"进入项目根目录之后可使用如下命令进行本地调试
php -S localhost:8000 -t . api/index.php在使用Nginx、阿帕奇、IIS等服务器软件时可将运行目录设置为api/，然后编写伪静态。
代码中已内置阿帕奇的伪静态方案。
在首次部署或数据库重置后，您需要手动运行数据库迁移来初始化表结构，这需要你的PostgreSQL用户拥有CREATE权限。请按照以下步骤操作：
- 确保已设置环境变量
DATABASE_URL和ADMIN_TOKEN。 - 通过浏览器访问
你的域名/migrate。 - 输入管理员Token。
- 点击“运行迁移”按钮。
- 迁移成功后，将自动重定向到管理面板。
注意：迁移只需运行一次，后续无需重复执行。如果数据库未迁移，系统可能无法正常运行。
迁移失败常见原因：
- 权限不足：确保用户有CREATE权限。
- Token错误：检查环境变量是否正确。
- 数据库连接失败：验证DATABASE_URL格式。
为了满足某些白嫖用户，我们专门针对Vercel做了部署支持。
Fork本仓库后，进入Vercel控制台导入该项目，按照环境变量格式填好环境变量即可搭建成功。
也可点击如下链接一键部署，部署成功后再填环境变量之后重新Deploy一次即可。
| 步骤 | 操作 |
|---|---|
| 1 | 注册 Supabase → 新建一个 Project（免费额度 500 MB 存储、每日 500 万次 API 调用） |
| 2 | 面包屑导航找到Connect按钮 → 选择 URI 格式 → 选择Session pooler |
| 3 | 复制连接串，格式大致如下：postgresql://用户名:密码@aws-0-ap-southeast-1.pooler.supabase.com:5432/postgres（建议模糊密码如***） |
| 4 | 把连接串粘贴到 Vercel 环境变量 DATABASE_URL 即可，无需额外建表，程序首次访问自动迁移 |
Supabase 免费额度足够个人使用，超出后可一键升级，按量计费。
此项目使用 MIT 协议 开源，允许自由使用、修改、分发、商用。
但我明确拒绝任何拉取请求（Pull Request）。请不要提交 PR，它们会被立即关闭。
如果你有新的想法，请提交Issue，我会视情况采纳；若发现项目有紧急漏洞或安全漏洞，请发送邮件到[email protected]。
你可以自由 fork 并维护自己的分支，但不要试图将修改合并回本仓库。
这不是开源的标准做法，但这是我选择的方式。