hoellen/privatebin

hoellen/privatebin 镜像文档

镜像概述

hoellen/privatebin 是一个基于 Alpine Linux 的 Docker 镜像，用于部署 PrivateBin——一款开源的在线粘贴板工具。其核心特点是服务器对用户粘贴的数据完全零知识，确保数据传输和存储的安全性，适用于需要私密分享文本、代码片段等信息的场景。

核心功能与特性

• 轻量级基础：基于 Alpine Linux（hoellen/nginx-php 镜像）构建，体积小且资源占用低
• 安全设计：使用 PrivateBin（原 zerobin 项目分支），实现服务器零知识数据处理
• 数据验证：内置 GPG 签名检查，确保软件完整性
• 数据隔离：独立的 /data 目录，便于数据持久化和管理
• 完整组件：捆绑 nginx 和 PHP，开箱即可使用，无需额外配置 Web 服务

使用场景

• 安全分享敏感文本信息（如密码、API 密钥等）
• 分享代码片段或日志，无需担心服务器存储或泄露内容
• 个人或团队内部私密信息传递
• 需要确保数据隐私性的在线粘贴需求

配置与使用说明

构建时变量

构建镜像时可通过以下变量指定 PrivateBin 版本：

• PRIVATEBIN_VER：PrivateBin 版本号

环境变量

运行容器时可通过环境变量调整配置：

• UID：privatebin 用户 ID
• GID：privatebin 用户组 ID
• MEMORY_LIMIT：PHP 内存限制（默认值：128M）
• UPLOAD_MAX_SIZE：最大上传文件大小（默认值：10M）

数据卷

为保证数据持久化，需挂载以下卷：

• /privatebin/data：存储 PrivateBin 数据（如粘贴内容、配置等）

端口

容器暴露端口：

• 8888：Web 服务端口（建议通过反向代理访问，而非直接暴露）

部署示例

Docker Run 命令

bash
docker run -d \
  --name privatebin \
  -p 8080:8888 \
  -v /path/to/privatebin/data:/privatebin/data \
  -e UID=1000 \
  -e GID=1000 \
  -e MEMORY_LIMIT=256M \
  -e UPLOAD_MAX_SIZE=20M \
  hoellen/privatebin

Docker Compose 配置

yaml
version: '3'
services:
  privatebin:
    image: hoellen/privatebin
    container_name: privatebin
    ports:
      - "8080:8888"
    volumes:
      - /path/to/privatebin/data:/privatebin/data
    environment:
      - UID=1000
      - GID=1000
      - MEMORY_LIMIT=256M
      - UPLOAD_MAX_SIZE=20M
    restart: unless-stopped

注意：生产环境中建议通过反向代理（如 Nginx、Traefik）访问容器的 8888 端口，并配置 HTTPS 以增强安全性。