wantguns/bin

wantguns/bin 镜像文档

镜像概述

wantguns/bin是一个轻量级的粘贴板（pastebin）服务，旨在提供简单高效的文本内容分享功能。用户可通过HTTP接口上传原始文本数据，服务返回可访问的唯一URL，支持原始内容获取和语法高亮的HTML页面展示，适合开发者快速分享代码片段、日志或临时文本信息。

核心功能与特性

• 简洁HTTP接口：提供POST和GET两种核心请求方式，操作直观
• 语法高亮支持：自动识别"text/*"类型内容并应用语法高亮
• 轻量部署：容器化设计，资源占用低，部署简单
• 持久化存储：通过卷挂载实现上传内容的本地持久化

API端点说明

POST /

• 功能：接收请求体中的原始数据，返回包含内容的访问URL
• 请求体：原始文本数据（无格式要求）
• 响应：包含唯一ID的URL（如 https://domain.com/<id>）

GET /<id>

• 功能：获取指定ID的原始文本内容
• 路径参数：<id> - 粘贴内容的唯一标识符
• 响应：原始文本内容（纯文本格式）

GET /p/<id>

• 功能：获取指定ID的语法高亮HTML页面
• 路径参数：<id> - 粘贴内容的唯一标识符
• 响应：带语法高亮效果的HTML页面

使用示例

使用cURL上传文件

bash
# 上传本地文件file.txt
curl --data-binary @file.txt https://bin.wantguns.dev

从标准输入上传内容

bash
# 上传"Hello, world."文本
echo "Hello, world." | curl --data-binary @- https://bin.wantguns.dev

配置.zshrc快捷命令

在.zshrc中添加以下函数，实现更便捷的使用：

bash
function paste() {
  local file=${1:-/dev/stdin}
  curl --data-binary @${file} https://bin.wantguns.dev
}

# 使用方法：
# 上传文件：paste example.txt
# 上传标准输入：echo "代码片段" | paste

部署指南

Traefik代理部署（docker-compose）

以下是使用Traefik作为反向代理的部署配置示例：

yaml
version: '3'

services:
  pastebin:
    image: wantguns/bin
    restart: always
    container_name: pastebin
    ports:
      - 127.0.0.1:6162:6162  # 本地端口映射，仅允许本地访问
    environment:
      - ROCKET_PORT=6162        # 服务监听端口
      - THEME=                  # 主题配置（留空使用默认主题）
      - HOST_URL=${BIN_DOMAIN}  # 外部访问域名（需替换为实际域名）
    volumes:
      - /path/to/local/upload:/app/upload  # 本地目录挂载，用于持久化存储上传内容
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.pastebin.rule=Host(`${BIN_DOMAIN}`)"
      - "traefik.http.routers.pastebin.entrypoints=secure"
      - "traefik.http.routers.pastebin.tls.certresolver=le"  # 启用Let's Encrypt证书
      - "traefik.http.services.pastebin.loadbalancer.server.port=6162"
    networks:
      - bin_network

networks:
  bin_network:
    external: true  # 需提前创建bin_network网络

环境变量说明

数据持久化

通过/app/upload卷挂载实现数据持久化，确保容器重启后上传的内容不会丢失。建议将本地目录（如/var/pastebin/upload）挂载到该路径。