dettmering/personal-timeline

Personal Timeline 部署文档

镜像概述

Personal Timeline是一个自托管的个人日志微站，支持微博客和个人日记功能。采用单二进制文件构建，依赖SQLite数据库，前端使用原生JS，无外部依赖，易于部署和管理。

核心功能

• 自托管：数据完全由用户掌控，可在本地或服务器部署
• 轻量：单二进制文件，无需额外依赖
• SQLite存储：无需独立数据库服务
• API支持：配置密钥后可自动化添加日志
• Webhook通知：新条目创建时触发POST请求
• 时区配置：支持设置时区以正确显示日期

使用场景

• 个人日常记录与日记管理
• 小型私人微博客
• 自动化日志收集（如脚本输出、服务状态监控）

配置说明

环境变量

Docker快速部署

bash
docker run -d \
  --name timeline \
  --restart unless-stopped \
  -p 8080:8080 \
  -v timeline-data:/data \
  -e TZ=Asia/Shanghai \
  dettmering/personal-timeline:latest

访问 http://localhost:8080 即可使用。

Docker Compose部署

yaml
services:
  timeline:
    image: dettmering/personal-timeline:latest
    container_name: timeline
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - timeline-data:/data
    environment:
      TZ: Asia/Shanghai
      # API_KEY: your-secure-key # 可选配置

volumes:
  timeline-data:

执行命令启动：docker compose up -d

API添加日志

配置API_KEY后，通过以下命令添加日志：

bash
curl -X POST http://localhost:8080/api/entries \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"text": "部署成功 #ops", "automated": true}'