wantguns/bin 是一个高度主观化的、极简的 pastebin 项目,使用它可以轻松通过网页或者命令行分享文本、图片和文件。
介绍
wantguns/bin 是一个极简的 pastebin,可以接受二进制文件,如图像、PDF,并提供多个客户端支持。
它不需要 SQL 服务器,所有功能都打包在一个静态链接的二进制文件中(Docker 镜像基于 scratch 运行!),这使得部署非常简单。
特点
- 不使用数据库。由于缺少密码保护和自动删除等非必要功能,它可以使用简单的文件系统,这一特性(个性化)使得部署更加简单
- 采用服务器端高亮技术,确保客户端保持轻便和快速
- 前端设计非常简约,因为 pastebin 并不需要复杂的界面。它力求(或者至少尽量)用最少的点击次数完成操作
地址
Demo:https://basedbin.fly.dev/
GitHub:https://github.com/wantguns/bin
Bin 展示
首页
文本发布页
粘贴图片并发布
拖动上传文件并发布
安装
1. SSH 登入服务器
这里使用一款基础的 1 CPU Core,2G RAM 的 VPS,运行 Debian 12 系统,来进行安装测试 Bin。
首先使用 SSH 客户端登入 VPS 终端。
下面的步骤也适用于可以安装和使用 Docker 的系统,例如可以安装 Docker Desktop 的 Windows 或 Mac。
2. 安装 Docker 与 Docker Compose
参考下面文章安装好 Docker 与 Docker Compose:
3. 创建安装目录
我们给 Bin 创建一个安装目录存放 Compose 配置文件,推荐创建在 /home
目录下,
cd /home mkdir bin cd bin
4. 创建 Compose 配置文件
创建 docker-compose.yml
文件,
touch docker-compose.yml
参考项目给出的配置,使用文本编辑器写入以下内容,
version: "3.3" services: pastebin: image: wantguns/bin container_name: pastebin ports: - 6163:6163 environment: - BIN_PORT=6163 - BIN_LIMITS={form="16 MiB"} - BIN_CLIENT_DESC=placeholder volumes: - ./upload:/upload
在配置段 '6163:6163'
中,前面的数字是我们访问 Bin 的端口,可以修改成任意未被占用的端口号。BIN_LIMITS
中可以设置可以上传文件的大小。
这里可以通过 Linux 系统上的文本编辑器,如 vi 打开 docker-compose.yml
,
vi docker-compose.yml
按 i 切换到编辑模式,将上面的内容粘贴进去,完成后先按一下 esc,然后输入 :wq
保存退出;
也可以使用 FinalShell 等 SSH 客户端的可视化编辑功能,双击打开 /home/bin/docker-compose.yml
,直接将上面的内容粘贴进去。
5. 启动容器
最后 Docker Compose 创建、启动容器,
docker-compose up -d
等待几分钟,打开本地浏览器输入 IP:6163 即可开始访问搭建好的 Bin。
配置反向代理
搭建好的 Bin 以IP:端口
的形式暴露访问,为了方便和安全,推荐为 Bin 配置反向代理,实现使用带 SSL/TLS 证书的域名来访问、使用容器。
为 Docker 容器配置反向代理的时候,假如我们有一个域名 example.com 用来反向代理,最佳实践是通过这个主域名的子域名来访问某个 Docker 容器。例如我有一个域名 044447.xyz,就可以通过子域名 bin.044447.xyz 来访问 Bin。
Cloudflare Tunnel
参考下面文章配置 Cloudflare Tunnel 进行反向代理:
Caddy
参考下面文章配置 Caddy 进行反向代理:
Nginx
暂未更新。
配置完,就可以使用域名访问 Bin 了。
更新、备份与卸载
更新
进入项目目录,
cd /home/bin
拉取最新的容器镜像,
docker-compose pull
热更新容器,
docker-compose up -d
删除所有未被容器使用的镜像。
docker image prune
备份
Bin 的数据库在项目目录的 /upload
文件夹,我们备份一下这个文件夹即可,以及 Docker Compose 文件。
卸载
进入项目目录,
cd /home/bin
停止正在运行中的容器,
docker-compose down
回到根目录,删除所有停止的容器、镜像及容器数据。
cd .. docker image prune -a