pasteme/frontend

PasteMe Frontend 镜像文档

镜像概述

PasteMe Frontend是PasteMe服务的官方前端Docker镜像，用于快速部署PasteMe Web应用的用户交互界面。PasteMe是一款轻量级文本粘贴与分享工具，类似pastebin服务，允许用户临时存储、分享文本内容（如代码片段、日志、配置文件等）。该镜像封装了PasteMe前端的静态资源和Web服务配置，可直接部署并与PasteMe后端服务配合，提供完整的用户体验。

核心功能特性

• 文本粘贴与分享：支持用户粘贴文本内容并生成唯一分享链接，支持一键复制链接
• 临时存储：文本内容临时存储，支持自定义过期时间（如1小时、1天、1周或永不过期）
• 语法高亮：内置多编程语言语法高亮，提升代码片段可读性（支持Python、JavaScript、Java等常见语言）
• 简洁界面：轻量化设计，无广告干扰，专注于文本分享核心功能
• 响应式布局：适配桌面端与移动端浏览器，支持多设备访问
• 后端联动：可灵活配置后端API地址，与PasteMe后端服务无缝通信

使用场景

• 开发者协作：分享代码片段、调试日志或配置文件，便于团队协作或问题排查
• 临时文本存储：临时保存跨设备访问的文本内容（如命令行指令、临时笔记）
• 技术支持：技术支持人员向用户分享操作步骤、代码示例或错误分析
• 教学场景：教师分享代码示例，学生间共享学习笔记或作业片段

使用方法

前提条件

• 已安装Docker环境（推荐Docker Engine 18.06+）
• 已部署PasteMe后端服务（需提供后端API地址，用于前端数据交互）

快速启动

通过以下命令快速部署前端服务（默认连接本地后端）：

bash
docker run -d \
  --name pasteme-frontend \
  -p 80:80 \
  -e API_URL=http://localhost:3000 \  # 后端API服务地址（必填）
  pasteme/frontend:latest

配置参数说明

端口映射

• 容器内默认监听80端口，建议映射到主机80或8080端口（如-p 8080:80）

环境变量配置

自定义配置示例

连接远程后端API并启用深色主题：

bash
docker run -d \
  --name pasteme-frontend \
  -p 8080:80 \
  -e API_URL=https://api.pasteme.example.com \  # 远程后端API地址
  -e THEME=dark \                               # 深色主题
  -e DEFAULT_EXPIRE=1h \                        # 默认1小时过期
  pasteme/frontend:latest

docker-compose 部署示例

通过docker-compose联动部署前端与后端服务：

yaml
version: '3'
services:
  frontend:
    image: pasteme/frontend:latest
    ports:
      - "80:80"
    environment:
      - API_URL=http://backend:3000  # 连接同网络内的后端服务
      - DEFAULT_EXPIRE=1d
    depends_on:
      - backend

  backend:
    image: pasteme/backend:latest  # PasteMe后端镜像
    environment:
      - DATABASE_URL=sqlite:///data/pasteme.db  # 后端数据库配置
    volumes:
      - pasteme-data:/data  # 持久化存储后端数据

volumes:
  pasteme-data:  # 后端数据卷

注意事项

• 后端依赖：必须配置正确的API_URL指向PasteMe后端服务，否则无法提交或加载文本
• HTTPS支持：生产环境建议配合反向代理（如Nginx、Traefik）配置SSL证书，实现HTTPS访问
• 版本控制：生产环境建议使用固定版本标签（如:v1.2.0）而非:latest，避免版本变更风险
• 资源限制：可通过--memory和--cpus参数限制容器资源占用（如--memory 128m --cpus 0.5）