【好玩的docker应用】用腾讯云搭建一个在线二步验证器——2FAuth ｜谷歌验证器（Google Authenticator）替代品

本博客用什么vps？创作不易，欢迎请作者喝杯咖啡☕☕☕

1.前言

这期我们来聊一聊二步验证。

双重认证Two-factor authentication，缩写为2FA，又称为双重验证、双因子认证、双因素认证，也有叫两步验证2-Step Verification，是多重要素验证中的一个特例，使用两种不同的元素，基于时间随机生成一串验证码用于和服务器验证的技术，来确认用户的身份。（类似之前网易的将军令和银行的电子令牌）

强烈建议每个人都用二步验证！

二步验证可以大大降低网络钓鱼攻击的成功率，减少盗号风险，即使我们的密码因为各种原因泄露了，由于黑客没有第二个验证因素，他们仍然无法访问我们的账户。

尽管二步验证不能提供100%的安全保障，但与单一密码相比，它显著增强了账户的安全性。

市面上有非常多的免费的两步验证工具，每一个工具大体上都差不多，但是也有一些区别。有一些人在选择双重验证工具时，可能比较看重安全性，认为那些带同步的双重验证软件有泄露的风险；有一些比较看重多设备同步，因为一旦手机丢失或者损坏，两步验证工具无法恢复数据将带来灾难性的后果。

如果你不想搭建，可以使用市面上的成熟产品，比如Google Authenticator或者authy，安卓可以使用Aegis

下面介绍一下我使用过的这几个软件的特点：

• Google Authenticator，谷歌出品，有Android 与 iOS客户端，支持云同步（但是不建议打开，有泄漏的风险）
• Aegis，免费开源的二次验证（2FA.��应用，可以导入导出，加密，自定义图标，夜间主题，选中高亮，没有云同步功能，且仅限安卓使用。（强烈推荐）
• Authy，适用于 Android 和 iOS 移动设备以及Windows，Apple Watch，桌面程序等全平台，也支持登陆账号，比较不错；缺点是不支持导出。
• Microsoft authenticator 不推荐使用，非常坑。

我目前使用的方式，主要用Google Authenticator（不开启同步功能），然后在家里的pixel手机上装了Aegis，备份一份。

今天我们来介绍自建2FA，把我们的2FA账户存储在我们自己的独立数据库中，可以轻松备份和恢复（再也不用担心手机丢失而导致所有2FA账户都无法访问的情况了……）

2. 项目展示

直接丢几个图：

主界面

!4cd2cecb9afe130c07956c8779edf89c.png

3. 相关地址

2fa GitHub仓库：https://2fa.org/
2fa 官方文档：https://docs.2fauth.app/
官方demo：https://demo.2fauth.app

4. 搭建环境

• 服务器：我这边用的是腾讯云的CN2 GIA的机器

莱卡云双十一打折活动火热进行中，

腾讯云双十一活动，2核2G的国内服务器一年只要88元，每人限购一台！

详情查看：https://cloud.tencent.com/act/pro/2023double11?from=21494?redirect=2446

新客专享活动，2核2G的香港服务器一年只要40元，每人限购一台！

当然你也可以用莱卡云 ，（最好选 非大陆的，而且线路还不错的机器）如果是小白刚开始玩的话，也可以选择Racknerd的高性价比服务器（注意地区选美国西部城市的）

• 系统：Debian 10 或以上。 DD 脚本 非必需 DD，用原来的系统也 OK，之后教程都是用 Debian 或者 Ubuntu 搭建～）
• docker 环境（具体看这篇：【Docker 系列】不用宝塔面板，小白一样可以玩转 VPS 服务器！）
• 【非必需但建议】域名一枚，并做好解析到服务器上
• 【非必需】提前安装好宝塔面板海外版本 aapanel，并安装好 Nginx
• 【非必需本教程选用】安装好 Nginx Proxy Manager（相关教程）

服务器建议：1C1G，能搭建docker即可

5. 搭建方式

如果你不是用的腾讯云的轻量应用服务器，可以直接跳到 6.1 部分。

安装系统（腾讯云轻量应用服务器）

腾讯云轻量服务器最大的特点就是 “轻量”，相比 CVM，更适合小白上手，这边我们之间选择 Docker 基础镜像，就可以省去后面安装 Docker 的步骤 （如果你非要用国内的服务器，这边装的 Docker 镜像还会帮你配置好国内镜像源，让你加速访问 docker 镜像资源） 不建议用国内的 。

登陆（腾讯云轻量应用服务器）

5.1 安装 Docker 与 Nginx Proxy Manager

可以直接参考这篇内容：

https://www.iigeek.com/archives/331

5.2 创建安装目录

创建一下安装的目录：

sudo -i

mkdir -p /home/docker_data/2fa

cd /home/docker_data/2fa

mkdir data

#修改目录所有者和权限
chown 1000:1000 data 
chmod 700 data

cd /home/docker_data/2fa
vim docker-compose.yml

英文输入法下，按 i

原版内容，环境变量非常多，还有smtp服务：

version: "3"
services:
  2fauth:
    image: 2fauth/2fauth
    container_name: 2fauth
    volumes:
      - ./2fauth:/2fauth
    ports:
      - 8000:8000/tcp
    environment:
      # 你可以更改应用程序的名称
      - APP_NAME=2FAuth
      # 你可以将其保留为“local”。如果你将其更改为“production”，大多数控制台命令将要求额外确认。
      # 永远不要将其设置为“testing”。
      - APP_ENV=local
      # 如果你想在错误屏幕中看到调试信息，请将此设为true。
      - APP_DEBUG=false
      # 这应该是你的电子邮件地址
      - SITE_OWNER=mail@example.com
      # 加密键用于你的数据库和会话。请确保这个非常安全。
      # 如果你生成了一个新的，所有现有的数据必须被视为丢失。
      # 将其更改为一个确切的32个字符的字符串，或使用命令`php artisan key:generate`来生成它
      - APP_KEY=SomeRandomStringOf32CharsExactly
      # 这个变量必须与你安装的外部地址匹配，但请记住，
      # 它只在命令行中使用作为回退值。
      - APP_URL=http://localhost
      # 如果你想让你的应用程序像演示一样反应，可以将此设置为true。
      # 演示模式每小时重置应用程序内容，并设置一个通用的演示用户。
      - IS_DEMO_APP=false
      # 日志通道定义了你的日志条目去哪里。
      # “daily”是默认的日志模式，为你提供在/storage/logs/下的5个日轮换日志文件。
      # 还存在多个其他选项。你可以使用“single”来获取一个很大的错误日志（不推荐）。
      # 还可以使用'syslog'、'errorlog'和'stdout'，它们会记录到系统本身。
      - LOG_CHANNEL=daily
      # 日志级别。你可以从最不严重到最严重设置：
      # debug, info, notice, warning, error, critical, alert, emergency
      # 如果设置为debug，你的日志会很快变大。如果设置为emergency，可能
      # 永远不会记录任何东西。
      - LOG_LEVEL=notice
      # 数据库配置（只能是sqlite）
      - DB_DATABASE="/srv/database/database.sqlite"
      # 如果你正在寻找性能改进，你可以安装memcached。
      - CACHE_DRIVER=file
      - SESSION_DRIVER=file
      # 邮件设置
      # 参考你的电子邮件提供商文档来配置你的邮件设置
      # 为每个可用的设置设置一个值以避免问题
      - MAIL_DRIVER=log
      - MAIL_HOST=smtp.mailtrap.io
      - MAIL_PORT=2525
      - MAIL_FROM=changeme@example.com
      - MAIL_USERNAME=null
      - MAIL_PASSWORD=null
      - MAIL_ENCRYPTION=null
      - MAIL_FROM_NAME=null
      - MAIL_FROM_ADDRESS=null
      # 认证设置
      # 默认的认证守护
      # 支持：
      #   'web-guard' : Laravel内置的auth系统（如果为null则为默认）
      #   'reverse-proxy-guard' : 当2FAuth部署在处理认证的反向代理后面时
      # 警告
      # 使用'reverse-proxy-guard'时，2FAuth只查找专用的头部信息并跳过所有其他内置的
      # 认证检查。这意味着你的代理完全负责认证过程，只要头部信息存在，2FAuth就
      # 会信任它。
      - AUTHENTICATION_GUARD=web-guard

这种应用，不用搞这么复杂，以下是我修改的：

version: "3"
services:
  2fauth:
    image: 2fauth/2fauth
    container_name: 2fauth
    volumes:
      - ./data:/2fauth
    ports:
      - 8120:8000/tcp
    environment:
      - APP_NAME=2FAuth
      - APP_KEY=SomeRandomStringOf32CharsExactly
      - APP_URL=https://2fa.uvh.cc
      - IS_DEMO_APP=false
      - LOG_CHANNEL=daily
      - LOG_LEVEL=notice
      - DB_DATABASE="/srv/database/database.sqlite"
      - CACHE_DRIVER=file
      - SESSION_DRIVER=file
      - AUTHENTICATION_GUARD=web-guard

切换成英文输入法，修改好之后，按一下 esc，然后 :wq 保存退出。

docker-compose up -d

5.3 打开服务器防火墙（非必需）并访问网页

打开防火墙的端口 8120

举例，腾讯云打开方法如下（部分服务商没有自带的面板防火墙，就不用这步操作了）：

类似图中的，这边我们填 8120，示例填 2fa ，确定即可（如果你在 docker-compose 文件里换了 9009，这边就需要填 9009，以此类推）

查看端口是否被占用（以 8120 为例），输入：

lsof -i:8120  #查看 8120 端口是否被占用，如果被占用，重新自定义一个端口

如果啥也没出现，表示端口未被占用，我们可以继续下面的操作了～

如果出现：

-bash: lsof: command not found

运行：

apt install lsof  #安装 lsof

如果端口没有被占用（被占用了就修改一下端口，比如改成 8381，注意 docker 命令行里和防火墙都要改）

理论上我们就可以输入 http://ip:8120 访问了。

但是这边我们必须先搞一下反向代理！

做反向代理前，你需要一个域名！

namesilo 上面 xyz 后缀的域名一年就 7 块钱，可以年抛。（冷知识，namesilo上 6位数字的xyz续费永远都是0.99美元 = =）

如果想要长期使用，还是建议买 com 后缀的域名，更加正规一些。

namesilo 自带隐私保护，我一直在用这家，价格也是这些注册商里面比较低的，关键是他家不像其他家域名注册商，没有七七八八的套路！（就是后台界面有些丑 古老 = =）

我们接着往下看！

6. 反向代理

6.1 利用 Nginx Proxy Manager

在添加反向代理之前，确保你已经完成了域名解析，不会的可以看这个：域名一枚，并做好解析到服务器上

之后，登陆 Nginx Proxy Manager（不会的看这个：安装 Nginx Proxy Manager（相关教程））

注意：

Nginx Proxy Manager（以下简称 NPM）会用到 80、443 端口，所以本机不能占用（比如原来就有 Nginx）

这边以2fa为例子，element也是一样操作即可。

直接丢几张图：

注意填写对应的 域名、IP 和 端口，按文章来的话，应该是 8120

IP 填写：

如果 Nginx Proxy Manager 和 2fa 在同一台服务器上，可以在终端输入：

ip addr show docker0

查看对应的 Docker 容器内部 IP。

否则直接填 2fa 所在的服务器 IP 就行。

6.2 利用宝塔面板

发现还是有不少小伙伴习惯用宝塔面板，这边也贴一个宝塔面板的反代配置：

直接新建一个站点，不要数据库，不要 php，纯静态即可。

然后打开下面的配置，修改 Nginx 的配置。

[

代码如下：

    location / {
      proxy_pass http://127.0.0.1:8120/;       # 注意改成你实际使用的端口
      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 更新 2fa

cd /home/docker_data/2fa

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 搭建的应用，更新非常容易～

7.2 卸载 2fa

同样进入安装页面，先停止所有容器。

cd /home/docker_data/2fa

docker-compose down

cd ..

rm -rf /home/docker_data/2fa  # 完全删除

可以卸载得很干净。

8. 常见问题及注意点

8.1 关闭注册

8.2 数据库加密

存储在数据库中的敏感数据（2FA秘钥和otpauth URI）可以进行加密，以保护它们免受数据库被攻破的风险。

在2FAuth的设置 > 选项部分中勾选“保护敏感数据”选项，启用加密功能。

加密适用于所有用户的数据。

警告
强烈建议在启用加密时备份.env文件中定义的APP_KEY值（或整个文件）。
如果丢失此密钥，则无法生成一次性密码。
如果遗失了该密钥，则没有任何解决办法。

9. 结尾

祝大家用得开心，有问题可以去 GitHub 提 Issues，也可以在评论区互相交流探讨。

同时，有能力给项目做贡献的同学，也欢迎积极加入到 项目 中来，贡献自己的一份力量！

最后，感谢开发人员们的辛苦付出，让我们能用到这么优秀的项目！

参考资料

https://github.com/Bubka/2FAuth