1. 前言
什么是 microbin ?
有时候你可能想从一台电脑上粘贴文本到另一台电脑上,或者是你想要分享一张图片或者是一些文件,但是用百度网盘登陆、上传、分享、下载太麻烦。
这个时候你可能会想要自建一个网盘,比如Nextcloud,或者是一个列表程序,比如alist,不过他们都相对来说比较“重”,功能太过丰富;
当然如果只是简单地分享一些文本,你或许想到了可以选择ubuntu官方提供的:https://paste.ubuntu.com/
不过它又太过简单,而且还必须登陆才能使用,太麻烦。
今天我们来介绍一款支持用docker搭建的轻应用——microbin,它可以完美实现上面提到的功能,和网盘相比,它足够轻量;和paste.ubuntu相比,它又有几个非常实用的小功能。
一起来试试看吧。
咕咕的Demo:https://paste.gugu.ovh/
功能
- 非常小巧
- 支持文件上传(例如:server.com/file/pig-dog-cat)
- 支持raw的文本服务(例如,server.com/raw/pig-dog-cat)
- 可以用来URL缩短和重定向
- 支持二维码
- 数据库非常简单(JSON+文件),可移植性强,易于备份和整合
- 支持列出使用过的列表
- 支持私有链接和公开链接,可编辑,可以设置链接的有效性
- 支持代码语法高亮
- 自动暗黑模式和自定义样式,只需很少的CSS和vanilla JS(见water.css)
- 默认以动物的名字作为结尾(可修改成随机字符)
1.1 相关地址
咕咕的Demo:https://paste.gugu.ovh/
文档:https://microbin.eu/documentation/
GitHub源码:https://github.com/szabodanika/microbin
Docker镜像:https://hub.docker.com/r/danielszabo99/microbin
捐助:https://microbin.eu/donate/
问题反馈:https://github.com/szabodanika/microbin/issues
2. 项目展示
这边直接丢出搭建的docker-compose.yaml文件,熟悉docker环境的小伙伴可以直接拷贝搭建。(环境变量可以自行参考文档按需修改)
version: '3.5'
services:
microbin:
image: danielszabo99/microbin:latest
container_name: microbin
restart: unless-stopped
environment:
- TZ=Asia/Shanghai
- MICROBIN_HIGHLIGHTSYNTAX=true
- MICROBIN_HASH_IDS=true
- MICROBIN_EDITABLE=true
- MICROBIN_PRIVATE=false
- MICROBIN_HIDE_FOOTER=true
- MICROBIN_HELP=true
# - MICROBIN_FOOTER_TEXT=gugu
- MICROBIN_HIDE_HEADER=true
- MICROBIN_HIDE_LOGO=false
- MICROBIN_NO_ETERNAL_PASTA=true
- MICROBIN_NO_FILE_UPLOAD=false
- MICROBIN_NO_LISTING=true
- MICROBIN_THREADS=2
- MICROBIN_TITLE=free-bin
- MICROBIN_PUBLIC_PATH=https://paste.gugu.ovh/ # 记得改成自己的网址
- MICROBIN_QR=true
ports:
- 8080:8080 # 冒号左边可以改成自己需要的端口号
volumes:
- ./microbin-data:/app/pasta_data # 冒号左边可以改自己想要的挂载路径
以下是详细搭建教程。
3. 搭建环境
- 服务器:
腾讯香港轻量应用服务器24元/月VPS一台咕咕自己搭建用的是OVH的独立服务器,演示用的是卢森堡的BuyVM,如果你只是小范围使用,可以考虑用腾讯轻量购买链接的服务器,(最好是选非大陆(香港)的服务器)如果是小白刚开始玩的话,还可以购买Racknerd的服务器,最低一年不到100块(不过这个建议选择1G内存以上的机器)(Racknerd服务器介绍:点击查看) - 系统:Debian 10(DD脚本 非必需DD用原来的系统也OK,之后教程都是用Debian或者Ubuntu搭建~)
- 安装好Docker、Docker-compose(相关脚本)
- 【非必需但建议】域名一枚,并做好解析到服务器上(域名购买、域名解析 视频教程)
- 【非必需】提前安装好宝塔面板海外版本aapanel,并安装好Nginx(安装地址)
- 【非必需本教程选用】安装好Nginx Proxy Manager(相关教程)
服务器要求:此项目比较重量,内存至少1G以上,硬盘越大越好。
4. 搭建视频
YouTube:https://youtu.be/tA6b2NPI26E
哔哩哔哩【高清版本可以点击去吐槽到B站观看】:<joe-bilibili bvid="BV1tG4y197oQ"></joe-bilibili>
5. 搭建方式
安装系统(腾讯云轻量应用服务器)
腾讯云轻量服务器最大的特点就是“轻量”,相比CVM,更适合小白上手,这边我们之间选择Docker基础镜像,就可以省去后面安装Docker的步骤(如果你非要用国内的服务器,这边装的Docker镜像还会帮你配置好国内镜像源,让你加速访问docker镜像资源)。
登陆(腾讯云轻量应用服务器)
5.1 服务器前期配置
服务器初始设置,参考:
这边由于我们用的是腾讯云轻量应用服务器,系统默认就帮我们创建了名字是lighthouse
的用户,系统后台也有防火墙(默认就开了几个常用的端口)
对小白用户来说,可以不用再去管繁琐的服务器安全的配置,大大降低了服务器防护的门槛。
【Docker系列】不用宝塔面板,小白一样可以玩转VPS服务器!
sudo -i # 切换到root用户
apt update -y # 升级packages
apt install wget curl sudo vim git -y # Debian系统比较干净,安装常用的软件
注意:VPS的内存如果过小,建议设置一下SWAP,一般为内存的1-1.5倍即可,可以让系统运行更流畅!
设置SWAP可以用脚本:
wget -O box.sh https://raw.githubusercontent.com/BlueSkyXN/SKY-BOX/main/box.sh && chmod +x box.sh && clear && ./box.sh
<img src="https://img.laoda.de/i/2022/05/28/uoikkd-0.webp" alt="image-20220528185512488" style="zoom:50%;" />
选择18
,然后输入你想要扩容的数值即可。
<img src="https://img.laoda.de/i/2022/05/28/up2dkf-0.webp" alt="image-20220528185604586" style="zoom:50%;" />
使用腾讯云轻量应用服务器的小伙伴可以直接跳到5.2.4
5.2 安装Docker(使用腾讯云轻量应用服务器可跳过这一部分)
5.2.1 非大陆服务器Docker安装
wget -qO- get.docker.com | bash
docker -v #查看docker版本
systemctl enable docker # 设置开机自动启动
修改Docker配置(可选)(来自烧饼博客)
以下配置会增加一段自定义内网 IPv6 地址,开启容器的 IPv6 功能,以及限制日志文件大小,防止 Docker 日志塞满硬盘(泪的教训):
cat > /etc/docker/daemon.json <<EOF
{
"log-driver": "json-file",
"log-opts": {
"max-size": "20m",
"max-file": "3"
},
"ipv6": true,
"fixed-cidr-v6": "fd00:dead:beef:c0::/80",
"experimental":true,
"ip6tables":true
}
EOF
然后重启 Docker 服务:
systemctl restart docker
5.2.2 非大陆服务器Docker-compose安装
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
docker-compose --version #查看docker-compose版本
5.2.3 国内服务器安装docker
curl -sSL https://get.daocloud.io/docker | sh
docker -v #查看docker版本
systemctl enable docker # 设置开机自动启动
修改Docker配置(可选)(来自烧饼博客)
以下配置会增加一段自定义内网 IPv6 地址,开启容器的 IPv6 功能,以及限制日志文件大小,防止 Docker 日志塞满硬盘(泪的教训):
cat > /etc/docker/daemon.json <<EOF
{
"log-driver": "json-file",
"log-opts": {
"max-size": "20m",
"max-file": "3"
},
"ipv6": true,
"fixed-cidr-v6": "fd00:dead:beef:c0::/80",
"experimental":true,
"ip6tables":true
}
EOF
然后重启 Docker 服务:
systemctl restart docker
5.2.4 国内服务器安装docker-compose
curl -L https://get.daocloud.io/docker/compose/releases/download/v2.1.1/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
docker-compose --version #查看docker-compose版本
5.3 安装NginxProxyManager
参考这边的内容:https://blog.laoda.de/archives/nginxproxymanager
5.4 创建安装目录
创建一下安装的目录:
sudo -i
mkdir -p /root/data/docker_data/microbin
cd /root/data/docker_data/microbin
这边我们直接用docker的方式安装。
vim docker-compose.yml
英文输入法下,按i
version: '3.5'
services:
microbin:
image: danielszabo99/microbin:latest
container_name: microbin
restart: unless-stopped
environment:
- TZ=Asia/Shanghai
- MICROBIN_HIGHLIGHTSYNTAX=true
- MICROBIN_HASH_IDS=true
- MICROBIN_EDITABLE=true
- MICROBIN_PRIVATE=false
- MICROBIN_HIDE_FOOTER=true
- MICROBIN_HELP=true
# - MICROBIN_FOOTER_TEXT=gugu
- MICROBIN_HIDE_HEADER=true
- MICROBIN_HIDE_LOGO=false
- MICROBIN_NO_ETERNAL_PASTA=true
- MICROBIN_NO_FILE_UPLOAD=false
- MICROBIN_NO_LISTING=true
- MICROBIN_THREADS=2
- MICROBIN_TITLE=free-bin
- MICROBIN_PUBLIC_PATH=https://paste.gugu.ovh/
- MICROBIN_QR=true
ports:
- 8080:8080
volumes:
- ./microbin-data:/app/pasta_data
按一下esc
,然后:wq
保存退出,之后,
最后:
cd /root/data/docker_data/microbin # 来到dockercompose文件所在的文件夹下
docker-compose up -d
5.5 打开服务器防火墙并访问网页
打开防火墙的端口8080
腾讯云打开方法如下:
<img src="https://img.laoda.de/i/2022/06/30/zlio5h-2.webp" alt="image-20220630215240864" style="zoom:33%;" />
<img src="https://img.laoda.de/i/2022/06/30/10h3dqt-2.webp" alt="image-20220630220546335" style="zoom:33%;" />
图中示例填的是5230
,备注填的是memos
,这边我们填8080
,示例填microbin
,确定即可(如果你在docker-compose文件里换了8081
,这边就需要填8081
,以此类推)
<img src="https://img.laoda.de/i/2022/08/19/o4byqz-2.webp" alt="image-20220819145844555" style="zoom:33%;" />
查看端口是否被占用(以8080
为例),输入:
lsof -i:8080 #查看8080端口是否被占用,如果被占用,重新自定义一个端口
如果啥也没出现,表示端口未被占用,我们可以继续下面的操作了~
如果出现:
-bash: lsof: command not found
运行:
apt install lsof #安装lsof
如果端口没有被占用(被占用了就修改一下端口,比如改成8081,注意docker命令行里和防火墙都要改)
理论上我们就可以输入http://ip:8080
访问了。
注意:
1、不知道服务器IP,可以直接在命令行输入:
curl ip.sb
,会显示当前服务器的IP。2、遇到访问不了的情况,请再次检查在宝塔面板的防火墙和服务商的后台防火墙是否打开对应了端口。
有的小伙伴可能想搭建起来分享给其他人使用,如果后续想要分享给别人,IP+端口太不优雅了,咕咕建议大家还是搞一个域名,容易记,看起来也更正规一点。这样可以做https,会让网页更安全。(非要IP+端口访问的,可以直接跳到5.6
,并且跳过6. 反向代理
部分)
而且namesilo上面xyz后缀的域名一年就7块钱,可以年抛。
如果想要长期使用,还是建议买com后缀的域名,更加正规一些,可以输入laodade
来获得1美元的优惠(不知道现在还有没有)
namesilo自带隐私保护,咕咕一直在用这家,价格也是这些注册商里面比较低的,关键是他家不像其他家域名注册商,没有七七八八的套路!(就是后台界面有些丑古老 = =)
【域名购买】Namesilo优惠码和域名解析教程(附带服务器购买推荐和注意事项)
我们接着往下看!
5.6 更新
5.6.1 docker-compose部署
cd /root/data/docker_data/microbin
docker-compose down
cp -r /root/data/docker_data/microbin /root/data/docker_data/microbin.archive # 万事先备份,以防万一,其实这边没必要,因为我们没有映射到本地文件夹
docker-compose pull
docker-compose up -d # 请不要使用docker-compose stop来停止容器,因为这么做需要额外的时间等待容器停止;docker-compose up -d直接升级容器时会自动停止并立刻重建新的容器,完全没有必要浪费那些时间。
docker image prune # prune 命令用来删除不再使用的 docker 对象。删除所有未被 tag 标记和未被容器使用的镜像
提示:
WARNING! This will remove all dangling images.
Are you sure you want to continue? [y/N]
输入y
利用Docker搭建的应用,更新非常容易~
5.7 卸载
cd /root/data/docker_data/microbin
docker-compose down
rm -rf /root/data/docker_data/microbin # 完全删除映射到本地的数据
可以卸载得很干净。
6. 反向代理
6.1 利用Nginx Proxy Manager
在添加反向代理之前,确保你已经完成了域名解析,不会的可以看这个:域名一枚,并做好解析到服务器上(域名购买、域名解析 视频教程)
之后,登陆Nginx Proxy Manager(不会的看这个:安装Nginx Proxy Manager(相关教程))
注意:
Nginx Proxy Manager(以下简称NPM)会用到
80
、443
端口,所以本机不能占用(比如原来就有Nginx)
直接丢几张图:
<img src="https://img.laoda.de/i/2022/05/02/kfes4s_7.webp" alt="image-20220502123517401" style="zoom: 33%;" />
注意填写对应的
域名
、IP
和端口
,按文章来的话,应该是8080
IP填写:
如果Nginx Proxy Manager和MicroBin在同一台服务器上,可以在终端输入:
ip addr show docker0
查看对应的Docker容器内部IP。
否则直接填microbin
所在的服务器IP就行。
<img src="https://img.laoda.de/i/2022/04/03/h9azjx_7.webp" alt="image-20220403104353185" style="zoom: 33%;" />
再次打开,勾选这些:
然后就可以用域名来安装访问了。
6.2 利用宝塔面板
发现还是有不少小伙伴习惯用宝塔面板,这边也贴一个宝塔面板的反代配置:
直接新建一个站点,不要数据库,不要php,纯静态即可。
然后打开下面的配置,修改Nginx的配置。
代码如下:
location / {
proxy_pass http://127.0.0.1:8080/; # 注意改成你实际使用的端口
rewrite ^/(.*)$ /$1 break;
proxy_redirect off;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Upgrade-Insecure-Requests 1;
proxy_set_header X-Forwarded-Proto https;
}
此方法对90%的反向代理都能生效。
有同学可能会问,为什么不直接用宝塔自带的反向代理功能。
也可以,不过咕咕自己之前遇到过当有多个网站需要反代的时候,在这边设置会报错的情况 = =
所以后来就不用了,直接用上面的方法来操作了。
7. 使用教程
7.1 安装和配置
见咕咕的视频。
8. 目前遇到的问题
8.1 页脚的自定义部分无法加入超链接
做了各种尝试,还是不行 = =
9. 结尾
祝大家用得开心,有问题可以去GitHub提Issues,也可以在评论区互相交流探讨。
同时,项目处于刚开始阶段,有能力给项目做贡献的同学,也欢迎积极加入到项目中来,贡献自己的一份力量!
参考资料
咕咕的Demo:https://paste.gugu.ovh/
文档:https://microbin.eu/documentation/
GitHub源码:https://github.com/szabodanika/microbin
Docker镜像:https://hub.docker.com/r/danielszabo99/microbin
网友评论