Idol Tracker - 开源追星神器部署指南

核心功能#

首页介绍#

部署后访客看到的首页，展示项目核心功能介绍：

动态聚合#

主界面 - 聚合展示所有关注爱豆的最新动态：

动态详情 - 点击查看某条动态的详细内容：

单个爱豆动态 - 查看某一位爱豆的所有动态：

美图画廊#

瀑布流展示爱豆高清美图：

超话自动签到#

自动完成每日超话签到，告别断签烦恼：

管理后台#

管理员登录：

数据概览 - 统计卡片 / 签到趋势图：

用户管理 - 用户列表 / 状态管理：

系统配置 - 爬虫间隔设置 / 推送配置：

环境要求#

• Node.js >= 18.0.0
• PostgreSQL >= 14
• Redis

Step 1: 克隆项目#

1
git clone https://github.com/1776686596/idol-tracker.git
2
cd idol-tracker
3
npm install

Step 2: 配置数据库#

创建 PostgreSQL 数据库：

1
CREATE DATABASE idol_tracker;
2
CREATE USER idoltracker WITH PASSWORD 'your-password';
3
GRANT ALL PRIVILEGES ON DATABASE idol_tracker TO idoltracker;

初始化表结构：

1
psql -U idoltracker -d idol_tracker -f packages/server/sql/init.sql

Step 3: 配置环境变量#

1
cp packages/server/.env.example packages/server/.env

编辑 .env 文件：

1
# 服务配置
2
PORT=3001
3
NODE_ENV=development
4

5
# 数据库
6
DATABASE_URL=postgresql://idoltracker:your-password@localhost:5432/idol_tracker
7

8
# JWT 密钥（生产环境请修改）
9
JWT_SECRET=your-super-secret-jwt-key
10

11
# Redis
12
REDIS_URL=redis://localhost:6379
13

14
# 微博爬虫（必填）
15
WEIBO_COOKIE=
16
WEIBO_XSRF_TOKEN=
17

18
# 企业微信推送（可选）
19
WECHAT_WEBHOOK_KEY=
20

21
# 邮件推送（可选）
22
SMTP_HOST=smtp.example.com
23
SMTP_PORT=465
24
SMTP_USER=notify@example.com
25
SMTP_PASS=your-smtp-password
26
SMTP_FROM=Idol Tracker <notify@example.com>

Step 4: 获取微博 Cookie#

这是最关键的一步，爬虫需要微博 Cookie 才能工作：

1. 登录 weibo.com
2. 按 F12 打开开发者工具
3. 切换到 Network 标签
4. 刷新页面，点击任意请求
5. 在 Request Headers 中找到 Cookie，复制整个值
6. 同样找到 x-xsrf-token，复制其值

将这两个值填入 .env 文件对应位置。

Step 5: 启动服务#

一键启动（推荐）：

1
npm run dev

这会同时启动三个服务：

• 用户前台：http://localhost:3000
• 管理后台：http://localhost:3002
• 后端 API：http://localhost:3001

单独启动：

1
npm run dev:web      # 用户前台
2
npm run dev:admin    # 管理后台
3
npm run dev:server   # 后端服务

Step 6: 登录系统#

默认管理员账号：

生产环境请务必修改默认密码！

查看爱豆动态#

1. 登录后进入主界面
2. 系统自动聚合所有关注爱豆的最新动态
3. 点击任意动态可查看详情

浏览美图画廊#

1. 进入「美图」页面
2. 瀑布流展示所有爱豆的高清图片
3. 支持大图预览和无限滚动

超话自动签到#

1. 绑定微博账号后自动开启
2. 每天早上 8:00 自动执行签到
3. 签到结果可通过企业微信/邮件推送

配置消息推送#

在管理后台「系统设置」中配置：

• 企业微信：填入群机器人 Webhook Key
• 邮件：配置 SMTP 服务器信息