timothystewart6/littlelink-server

LittleLink-Server

镜像概述和主要用途

LittleLink-Server 是一个基于 https://github.com/sethcottle/littlelink 项目的轻量级链接聚合页面解决方案。它采用简洁的链接页面设计理念，通过 NodeJS 服务器和 React 服务端渲染（SSR）实现，并提供容器化部署方式。用户可通过环境变量轻松自定义链接页面，无需修改代码即可快速搭建个人或品牌的链接聚合页，替代 Linktree 等商业服务。

核心功能和特性

• 轻量级架构：基于 Skeleton 响应式框架构建，加载速度快，性能优异（Google *** 性能评分达 99/100）
• 灵活自定义：通过环境变量配置标题、描述、头像、按钮顺序、自定义按钮等所有页面元素
• 丰富按钮支持：内置 20+ 主流平台的品牌按钮样式（完整列表见 https://github.com/techno-tim/littlelink-server/blob/master/src/config.js%EF%BC%89
• 多分析集成：支持 Google Analytics、Umami、Matomo 分析工具，自动跟踪按钮点击事件
• 健康检查：提供 /healthcheck 健康检查端点，支持跳过日志记录
• 主题切换：内置明暗两种主题，通过环境变量一键切换
• 容器化部署：支持 Docker 和 Kubernetes，部署简单高效

使用场景和适用范围

• 个人创作者：集中展示社交媒体账号、视频频道、直播平台、赞助链接等
• 内容生产者：整合教程文档、推荐资源、联系方式等关键链接
• 品牌/企业：聚合官方网站、产品页面、招聘信息等核心入口
• 活动推广：统一管理报名链接、日程安排、相关资源等活动信息

详细使用方法和配置说明

环境变量配置

分析工具配置

Google Analytics

1. 参考 Google Analytics 入门指南 获取跟踪 ID（格式：G-XXXXXXXXXX）
2. 设置环境变量：GA_TRACKING_ID=G-XXXXXXXXXX
3. 按钮点击事件将自动发送，事件格式：window.gtag('event', '平台-button')（如 *** 按钮事件为 youtube-button）

Umami

1. 参考 Umami 数据收集指南 添加网站并生成跟踪代码（格式如下）：

   javascript
   <script async defer data-website-id="00000000-1111-2222-3333-444444444444" src="https://your-umami-app.com/umami.js"></script>
   

2. 设置环境变量：
   • UMAMI_WEBSITE_ID=00000000-1111-2222-3333-444444444444（对应 data-website-id）
   • UMAMI_APP_URL=https://your-umami-app.com/umami.js（对应 src）
3. 按钮点击事件自动发送，格式：window.umami('平台-button')

Matomo

1. 参考 Matomo 安装指南 配置分析工具，并获取 网站 ID
2. 设置环境变量：
   • MATOMO_URL=https://your-matomo-instance.com（Matomo 实例 URL）
   • MATOMO_SITE_ID=1（网站 ID）
3. 按钮点击事件自动发送，格式：window._paq.push(['trackEvent', '平台-button']])

健康检查

• 健康检查端点：/healthcheck，健康时返回状态码 200 和响应：

  json
  {
    "status": "ok"
  }
  

• 跳过健康检查日志：设置环境变量 SKIP_HEALTH_CHECK_LOGS=true

Docker 部署

Docker Compose 示例

yaml
---
version: "3.0"
services:
  littlelink-server:
    image: ghcr.io/techno-tim/littlelink-server:latest  # 或 DockerHub 镜像：timothystewart6/littlelink-server:latest
    container_name: littlelink-server
    environment:
      - META_TITLE=Techno Tim
      - META_DESCRIPTION=软件工程师 | 游戏玩家 | Twitch 主播 | YouTube 内容创作者 | 家庭实验室 | 🇺🇸 🇯🇵 | 技术爱好者
      - META_AUTHOR=Techno Tim
      - LANG=en
      - META_INDEX_STATUS=all
      - OG_SITE_NAME=Techno Tim
      - OG_TITLE=Techno Tim
      - OG_DESCRIPTION=Techno Tim 的链接聚合页
      - OG_URL=https://technotim.live
      - OG_IMAGE=https://pbs.twimg.com/profile_images/1286144221217316864/qIAsKOpB_400x400.jpg
      - OG_IMAGE_WIDTH=400
      - OG_IMAGE_HEIGHT=400
      - GA_TRACKING_ID=G-XXXXXXXXXX  # 替换为实际 Google Analytics ID
      - THEME=Dark
      - FAVICON_URL=https://pbs.twimg.com/profile_images/1286144221217316864/qIAsKOpB_200x200.jpg
      - AVATAR_URL=https://pbs.twimg.com/profile_images/1286144221217316864/qIAsKOpB_200x200.jpg
      - AVATAR_2X_URL=https://pbs.twimg.com/profile_images/1286144221217316864/qIAsKOpB_400x400.jpg
      - AVATAR_ALT=Techno Tim 头像
      - NAME=TechnoTim
      - BIO=嘿！这是一个可以连接到我的所有平台的地方！
      - BUTTON_ORDER=YOUTUBE,TWITCH,TWITTER,GITHUB,INSTAGRAM,DISCORD,FACEBOOK,TIKTOK,PATREON,GEAR,DOCUMENTATION
      # 自定义按钮配置（多按钮用逗号分隔）
      - CUSTOM_BUTTON_TEXT=文档,推荐设备
      - CUSTOM_BUTTON_URL=https://l.technotim.live/docs,https://l.technotim.live/gear
      - CUSTOM_BUTTON_COLOR=#000000,#000000
      - CUSTOM_BUTTON_TEXT_COLOR=#ffffff,#ffffff
      - CUSTOM_BUTTON_ALT_TEXT=视频教程文档和更多内容,推荐设备清单
      - CUSTOM_BUTTON_NAME=DOCUMENTATION,GEAR
      - CUSTOM_BUTTON_ICON=fas file-alt,fas fa-cog
      # 平台链接
      - GITHUB=https://l.technotim.live/github
      - TWITTER=https://l.technotim.live/twitter
      - INSTAGRAM=https://l.technotim.live/instagram
      - YOUTUBE=https://l.technotim.live/subscribe
      - TWITCH=https://l.technotim.live/twitch
      - DISCORD=https://l.technotim.live/discord
      - TIKTOK=https://l.technotim.live/tiktok
      - FACEBOOK=https://l.technotim.live/facebook
      - PATREON=https://l.technotim.live/patreon
      - FOOTER=Techno Tim © 2022
    ports:
      - 8080:3000  # 宿主机端口:容器端口（容器内固定使用 3000）
    restart: unless-stopped
    security_opt:
      - no-new-privileges:true

Docker Run 命令示例

bash
docker run -d \
  --name=littlelink-server \
  -p 8080:3000 \
  -e META_TITLE='Techno Tim' \
  -e META_DESCRIPTION='Techno Tim 的链接聚合页' \
  -e META_AUTHOR='Techno Tim' \
  -e LANG=en \
  -e META_INDEX_STATUS='all' \
  -e THEME='Dark' \
  -e FAVICON_URL='https://pbs.twimg.com/profile_images/1286144221217316864/qIAsKOpB_200x200.jpg' \
  -e AVATAR_URL='https://pbs.twimg.com/profile_images/1286144221217316864/qIAsKOpB_200x200.jpg' \
  -e AVATAR_2X_URL='https://pbs.twimg.com/profile_images/1286144221217316864/qIAsKOpB_400x400.jpg' \
  -e AVATAR_ALT='Techno Tim 头像' \
  -e NAME='TechnoTim' \
  -e BIO='嘿！这是一个可以连接到我的所有平台的地方！' \
  -e GITHUB='https://l.technotim.live/github' \
  -e TWITTER='https://l.technotim.live/twitter' \
  -e INSTAGRAM='https://l.technotim.live/instagram' \
  -e YOUTUBE='https://l.technotim.live/subscribe' \
  -e TWITCH='https://l.technotim.live/twitch' \
  -e DISCORD='https://l.technotim.live/discord' \
  -e FOOTER='Techno Tim © 2022' \
  --restart unless-stopped \
  ghcr.io/techno-tim/littlelink-server:latest

Kubernetes 部署

可使用 k8s-at-home 提供的非官方 Helm Chart：

bash
# 添加 Helm 仓库
helm repo add k8s-at-home https://k8s-at-home.com/charts/
helm repo update

# 安装 Chart（示例配置）
helm install littlelink-server \
  --set env.TZ="America/New York" \
  --set env.META_TITLE="TechnoTim" \
  k8s-at-home/littlelink-server

或使用 values.yaml 文件自定义配置：

bash
helm install littlelink-server k8s-at-home/littlelink-server -f values.yaml