Telegram自动签到项目使用指南

github地址：https://github.com/akasls/TG-SignPulse

第一步：创建项目目录

mkdir -p ~/tg-signpulse
cd ~/tg-signpulse

mkdir 是创建文件夹，cd 是进入这个文件夹。之后所有操作都在这个目录里进行。

第二步：新建 docker-compose.yml 文件

用 nano 编辑器创建文件（nano 是最简单的命令行编辑器，几乎所有 Linux 都有）：

nano docker-compose.yml

执行后界面会变成一个空白编辑区，然后用下面这条命令整体覆盖重写文件（复制整段一起执行）：

cat > ~/tg-signpulse/docker-compose.yml << 'EOF'
services:
  app:
    image: ghcr.io/akasls/tg-signpulse:latest
    container_name: tg-signpulse
    ports:
      - "8080:8080"
    volumes:
      - ./data:/data
    environment:
      - PORT=8080
      - TZ=Asia/Shanghai
    restart: unless-stopped
EOF

执行完后确认文件内容正确：

cat ~/tg-signpulse/docker-compose.yml

应该能看到整齐的内容

第三步：安装 Docker

一条命令搞定（官方安装脚本，适用于 Ubuntu/Debian）：

curl -fsSL https://get.docker.com | sh

等它跑完（1~2分钟），然后验证是否安装成功：

docker --version

能看到版本号就说明装好了，比如 Docker version 27.x.x

第四步：然后直接重新启动项目

cd ~/tg-signpulse
docker compose up -d

启动后验证容器是否在运行：

docker ps

你应该能看到 tg-signpulse 这个容器，状态是 Up。

第五步：访问 Web 面板

在你的本地浏览器（不是 VPS 上）打开：

http://你的VPS_IP:8080

如果你的 VPS 有防火墙，需要先放行 8080 端口。以常见面板为例：

  • 1Panel：进入面板 → 安全 → 防火墙 → 添加规则，放行 TCP 8080

  • 宝塔：安全 → 防火墙 → 添加端口 8080

  • 无面板裸机：执行 ufw allow 8080

打开页面后，用以下默认账号密码登录：

  • 用户名：admin

  • 密码：admin123

登录后立刻去设置里改掉默认密码。

第六步：在面板里添加你的 Telegram 账号

  1. 登录面板后，点左侧菜单"账号管理"

  2. 点"添加账号"按钮

  3. 选择登录方式（手机号验证码 或 扫码登录）

  4. 如果用手机号：输入你的手机号（格式如 +8613800138000）

  5. Telegram 会给你发一条验证码消息，收到后填入

  6. 如果你的账号设置了两步验证密码（Cloud Password），还需要填一次密码

  7. 账号出现在列表里，说明登录成功

第七步：新建签到任务

  1. 点左侧"任务管理"

  2. 点"新建任务"

  3. 选择刚才添加的账号

  4. 在聊天搜索框里搜索你要签到的机器人名称，选中

  5. 填写发送的签到内容（比如 /sign、签到、打卡，取决于那个机器人的规则）

  6. 设置执行时间，建议勾选"时间随机化"选项，让发送时间有几分钟的随机偏差，减少被风控的概率

  7. 点保存，然后启用任务

dark
sans