10分钟跑通自己的短链接站:kutt 自托管零配置上手
10分钟跑通自己的短链接站kutt 自托管零配置上手【免费下载链接】kuttFree Modern URL Shortener.项目地址: https://gitcode.com/GitHub_Trending/ku/kutt想发给同事的链接有 300 多个字符往 IM 里一贴折了两行对方还得全选复制。你要的其实就是一条几个字符的短链随手转发、点击数还能随时看。kutt 就是一个免费、自托管的现代短链接服务URL Shortener默认用 SQLite 存数据不用装数据库仓库里没有构建步骤clone 下来就能跑。下面这条流程大概 10 分钟能走完顺手把按场景调参数和最容易踩的坑都讲了。跑通它4 条命令出第一条短链唯一的前置条件是 Node.js 20 以上。打开终端在你想放代码的目录里执行git clone https://gitcode.com/GitHub_Trending/ku/kutt cd kutt npm install npm run migrate npm run devnpm run migrate负责初始化数据库跑 knex 迁移脚本npm run dev带文件监听启动服务。浏览器打开localhost:3000第一次访问会直接把你带到创建管理员账户页面填好邮箱密码就进入主站。首页粘贴一条长 URL、点发送6 个字符的短链就出来了点进链接详情能看到每次点击的统计。这里省事的原因是默认数据库就是 SQLite数据落在db/目录下一个文件里端口默认 3000你什么都不用准备。更省事Docker 一行启动不想在机器上装 Node 的话仓库根目录自带几套 compose 配置。最原味的是 docker-compose.ymlSQLite 数据卷docker compose up容器启动时会自动先跑迁移再启动应用见 Dockerfile 最后的 CMD。SQLite 数据文件被挂到命名卷里custom/目录也做了挂载——后面要改主题就把文件放这里。想上 Postgres 或 MariaDB换成 docker-compose.postgres.yml 或 docker-compose.mariadb.yml按注释补上DB_PASSWORD、DB_NAME等几个必需变量即可。按场景调所有参数都是环境变量配置全靠环境变量直接传或者写进.env文件都行完整清单参考 env 配置模板解析逻辑在 server/env.js——遇到没定义的变量启动会直接报错拼错一个字母藏不住。几个大概率要动的SITE_NAME我的短链站 DEFAULT_DOMAINlink.example.com JWT_SECRET一串足够长的随机字符串 PORT3000DEFAULT_DOMAIN决定生成的短链长什么样正式对外开放前一定先设好JWT_SECRET是登录态 token 的签名密钥生产环境必填DISALLOW_ANONYMOUS_LINKS控制未登录能否建链默认禁止保持默认就对了TRUST_PROXY声明应用是否跑在 nginx 或 Cloudflare 后面。没有代理就设false否则用户可以伪造 IP统计页的访客 IP 会一片混乱。这里有个坑提前说注册默认是关的DISALLOW_REGISTRATIONtrue。想开放注册得先把邮件跑通——MAIL_ENABLED加一组MAIL_*变量因为注册流程依赖验证邮件。内部给团队用更干净的做法是开 OIDCOIDC_ENABLED及相关变量让同事拿现成的 SSO 登录连注册都省了。正式环境用npm start启动自动带上--production从这一刻起JWT_SECRET不填就起不来这是故意的别嫌它烦。避坑这四个地方最容易绊一下想换数据库驱动sqlite3和pg-native这两个 client 默认没装进依赖得先手动npm install再改DB_CLIENT否则启动报错很费解。自定义域名短链可以挂你自己的子域名CUSTOM_DOMAIN_USE_HTTPS控制生成的链接用不用 https。但注意这些域名的 SSL 证书要你自己签发挂载应用不负责。接口被刷ENABLE_RATE_LIMITtrue打开限流启了 Redis 就用 Redis 计数否则走内存。生产环境建议顺手把REDIS_ENABLED也开了缓存和限流一起受益。db/目录别乱动那是 SQLite 的数据本体用 Docker 的话对应的是那个db_data_sqlite卷。要备份备份它。回到开头那个场景现在你 IM 里那条 300 字的链接已经变成 6 个字符每次点开都留了记录。下一步值得做的事按顺序排绑定自己的域名让短链更像正式出品开邮件或 OIDC 把注册放给团队再把 CSS 和页面模板丢进 custom/ 目录换成你自己的皮肤。想深入源码全部逻辑在 server/ 下路由、数据模型、迁移脚本分目录放着结构很直白。【免费下载链接】kuttFree Modern URL Shortener.项目地址: https://gitcode.com/GitHub_Trending/ku/kutt创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

InsForge UI 包开发指南:可复用组件库的边界、实现规范与验证流程

InsForge UI 包开发指南:可复用组件库的边界、实现规范与验证流程

InsForge UI 包开发指南:可复用组件库的边界、实现规范与验证流程 【免费下载链接】InsForge The all-in-one, open-source backend platform for agentic coding. InsForge gives your coding agent database, auth, storage, compute, hosting, and AI gateway to…

2026/11/17 1:16:50 阅读更多 →
Loop:免费开源的macOS窗口管理工具,一个径向菜单摆好所有窗口

Loop:免费开源的macOS窗口管理工具,一个径向菜单摆好所有窗口

Loop:免费开源的macOS窗口管理工具,一个径向菜单摆好所有窗口 【免费下载链接】Loop Window management made elegant. 项目地址: https://gitcode.com/GitHub_Trending/lo/Loop Loop 是一款免费开源的 macOS 窗口管理工具。它把鼠标拖拽换成按键…

2026/10/25 11:13:28 阅读更多 →
Astryx 贡献指南深度解读:PR 意图、公共 API 与 CLI 约定全解析

Astryx 贡献指南深度解读:PR 意图、公共 API 与 CLI 约定全解析

Astryx 贡献指南深度解读:PR 意图、公共 API 与 CLI 约定全解析 【免费下载链接】astryx An open source design system thats fully customizable and agent ready 项目地址: https://gitcode.com/GitHub_Trending/as/astryx 导读 本篇文章以 Astryx 开源设…

2026/11/16 9:58:36 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/16 8:22:12 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/16 6:41:34 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/16 8:22:12 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/16 8:22:12 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/16 7:30:18 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/16 8:22:12 阅读更多 →

日新闻

周新闻

月新闻