mtlynch/logpaste

logpaste

一个极简的Web服务，用于上传和分享日志文件。

!https://raw.githubusercontent.com/mtlynch/logpaste/master/.readme-assets/demo.gif

核心功能和特性

• 支持从命令行、JavaScript和Web界面上传文本
• 部署简单
  • 单Docker容器运行
  • 适合Heroku免费层
• 数据库管理简单
  • 将持久化数据同步到任何S3兼容云存储服务
• 无需修改源码即可自定义UI

演示

• <[***]>

运行LogPaste

从源码运行

bash
PORT=3001 go run main.go

从Docker运行

要在Docker容器中运行LogPaste，需挂载本地卷以存储LogPaste sqlite数据库：

bash
docker run \
  -e "PORT=3001" \
  -p 3001:3001/tcp \
  --volume "${PWD}/data:/app/data" \
  --name logpaste \
  mtlynch/logpaste

从Docker + 云数据复制

如果指定S3存储桶设置，LogPaste将使用Litestream自动将数据复制到S3。即使终止容器后重新启动，也会从S3存储桶恢复数据并继续运行，不受中断影响。

bash
LITESTREAM_ACCESS_KEY_ID=你的访问ID
LITESTREAM_SECRET_ACCESS_KEY=你的密钥
LITESTREAM_REGION=你的区域
DB_REPLICA_URL=s3://你的存储桶名称/db

docker run \
  -e "PORT=3001" \
  -e "LITESTREAM_ACCESS_KEY_ID=${LITESTREAM_ACCESS_KEY_ID}" \
  -e "LITESTREAM_SECRET_ACCESS_KEY=${LITESTREAM_SECRET_ACCESS_KEY}" \
  -e "LITESTREAM_REGION=${LITESTREAM_REGION}" \
  - -e "DB_REPLICA_URL=${DB_REPLICA_URL}" \
  -p 3001:3001/tcp \
  --name logpaste \
  mtlynch/logpaste

注意事项：

• 每个S3位置仅运行一个Docker容器
  • LogPaste无法跨多个实例同步写入操作

自定义站点设置

LogPaste提供自定义站点文本的选项，以下示例自定义了标题、副标题和页脚：

bash
SITE_TITLE="我的日志粘贴服务"
SITE_SUBTITLE="在此上传所有FooBar日志"
SITE_FOOTER="<h2>注意</h2><p>仅允许特定用户在此分享日志。</p>"
SITE_DARK_MODE="true"
SITE_SHOW_DOCUMENTATION="false" # 隐藏首页使用说明
PER_MINUTE_LIMIT="5" # 限制每IP每分钟最多5次粘贴

docker run \
  -e "PORT=3001" \
  -e "SITE_TITLE=${SITE_TITLE}" \
  -e "SITE_SUBTITLE=${SITE_SUBTITLE}" \
  -e "SITE_FOOTER=${SITE_FOOTER}" \
  -e "SITE_DARK_MODE=${SITE_DARK_MODE}" \
  -e "SITE_SHOW_DOCUMENTATION=${SITE_SHOW_DOCUMENTATION}" \
  -e "PER_MINUTE_LIMIT=${PER_MINUTE_LIMIT}" \
  -p 3001:3001/tcp \
  --name logpaste \
  mtlynch/logpaste

参数

命令行标志

Docker环境变量

可通过docker run -e传递以下参数调整容器行为：

Docker构建参数

如果从源码重新构建Docker镜像，可通过docker build --build-arg调整构建行为：

部署

LogPaste易于部署到云服务，以下平台适用：

• fly.io（推荐）
• Heroku
• Google Cloud Run
• Amazon LightSail

进一步阅读

• "Litestream如何以每月0.03***成本淘汰我的数据库服务器"：解释LogPaste的设计动机