darkver8/2fa repository overview

⁠Cosmo 2FA - 现代化在线二步验证系统

⁠🌟 核心特性

• 🍏 苹果毛玻璃拟态 (Apple Liquid Glass)：精致深邃的黑曜石深色模式与空灵白瓷浅色模式，流线胶囊导航与触控回弹。
• ⚡ 即开即用快捷取码：临时取码无需注册，支持密钥输入、二维码图片导入及 Ctrl+V 截图直接粘贴识码。
• ⏱️ 下一轮验证码预告 (Next Code)：实时展示下轮验证码，避免倒计时临期输入失效。
• 🔐 多设备账号云端安全同步：内置轻量安全数据库，密码经 PBKDF2-SHA512 随机盐强哈希加密，多端隔离同步。
• 📋 批量取码矩阵：支持多账号矩阵批量生成与一键复制全部验证码。
• 🌐 开放 OTP 接口：支持通过 /otp/SECRET_KEY 在浏览器、快捷指令或脚本中直接获取实时验证码。
• 📱 移动端深度适配：零水平晃动、流线分段式导航，自适应全尺寸手机屏幕。
• 🐳 多架构容器原生支持：支持 linux/amd64 与 linux/arm64（Apple Silicon M系列 / 树莓派 / ARM云主机）。

⁠🚀 极速运行指南

⁠1. Docker 命令一键运行

docker run -d \
  --name cosmo-2fa \
  --restart unless-stopped \
  -p 3000:3000 \
  -v $(pwd)/data:/app/data \
  darkver8/cosmo-2fa:latest

启动后在浏览器打开 http://服务器IP:3000 即可开始使用。

⁠2. Docker Compose 部署 (推荐)

创建 docker-compose.yml 文件：

version: '3.8'

services:
  cosmo-2fa:
    image: darkver8/cosmo-2fa:latest
    container_name: cosmo-2fa
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./data:/app/data
    environment:
      - PORT=3000
      - HOST=0.0.0.0

一键启动：

docker compose up -d

⁠⚙️ 环境变量与目录挂载

⁠🏷️ 支持平台与架构

• linux/amd64：标准 Intel / AMD 64位服务器、云主机、PC
• linux/arm64：Apple Silicon (M1/M2/M3/M4)、树莓派、ARM 架构云服务器

⁠🔗 相关链接

• GitHub 开源仓库: https://github.com/qwernot/2fa⁠