asmaps/bepasty

bepasty-docker 镜像文档

镜像概述和主要用途

bepasty-docker是https://github.com/bepasty/bepasty-server%E7%9A%84Docker%E8%87%AA%E5%8A%A8%E6%9E%84%E5%BB%BA%E4%BB%93%E5%BA%93%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%BE%BF%E6%8D%B7%E7%9A%84%E6%96%87%E4%BB%B6%E5%85%B1%E4%BA%AB%E6%9C%8D%E5%8A%A1%E5%99%A8%E9%83%A8%E7%BD%B2%E6%96%B9%E6%A1%88%E3%80%82%E9%80%9A%E8%BF%87%E5%AE%B9%E5%99%A8%E5%8C%96%E6%96%B9%E5%BC%8F%E7%AE%80%E5%8C%96bepasty-server%E7%9A%84%E5%AE%89%E8%A3%85%E4%B8%8E%E9%85%8D%E7%BD%AE%E6%B5%81%E7%A8%8B%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E9%9C%80%E8%A6%81%E5%BF%AB%E9%80%9F%E6%90%AD%E5%BB%BA%E6%96%87%E4%BB%B6%E4%B8%8A%E4%BC%A0%E3%80%81%E5%AD%98%E5%82%A8%E4%B8%8E%E5%85%B1%E4%BA%AB%E6%9C%8D%E5%8A%A1%E7%9A%84%E5%9C%BA%E6%99%AF%E3%80%82

核心功能和特性

• 自动构建：基于bepasty-server官方代码自动构建，确保镜像与最新版本同步
• 数据持久化：通过卷挂载实现数据存储在主机，避免容器删除导致数据丢失
• 配置自定义：生成可编辑的配置文件，支持根据需求调整服务器参数
• 自动重启：支持Docker的--restart=always策略，确保服务稳定运行（需Docker 1.2及以上版本）

使用场景和适用范围

• 个人文件临时存储与共享
• 团队内部文件交换与协作
• 小型组织的简易文件服务器搭建
• 需要快速部署且低维护成本的文件共享场景

使用方法和配置说明

前提条件

• 系统已安装Docker（需1.2及以上版本以支持重启功能）
• 参考Docker安装文档完成环境配置

首次启动与配置

1. 拉取镜像并创建容器

执行以下命令拉取镜像（如本地未缓存）并创建容器：

bash
docker run -d --restart=always --name bepasty -p 127.0.0.1:5000:5000 -v /opt/bepasty:/srv/bepasty asmaps/bepasty

参数说明：

• -d：后台运行容器
• --restart=always：容器退出时自动重启
• --name bepasty：指定容器名称为bepasty
• -p 127.0.0.1:5000:5000：将容器的5000端口映射到主机的127.0.0.1:5000（仅本地访问）
• -v /opt/bepasty:/srv/bepasty：将主机的/opt/bepasty目录挂载到容器内的/srv/bepasty，用于持久化数据和配置

2. 配置文件调整

容器启动后，配置文件会自动生成在主机的/opt/bepasty/bepasty.conf路径。根据需求编辑该文件调整服务器参数（如上传大小限制、存储路径等），保存后重启容器使配置生效。

停止服务器

bash
docker stop bepasty

启动服务器

若已通过--restart=always配置，容器会自动启动。手动启动命令：

bash
docker start bepasty

更新镜像

由于数据存储在主机，更新时需先停止并删除旧容器，拉取新镜像后重新创建容器：

bash
# 停止旧容器
docker stop bepasty

# 删除旧容器
docker rm bepasty

# 拉取最新镜像
docker pull asmaps/bepasty

# 创建新容器（参数与首次启动一致）
docker run -d --restart=always --name bepasty -p 127.0.0.1:5000:5000 -v /opt/bepasty:/srv/bepasty asmaps/bepasty