theanurin/luksoid

Luksoid

Luksoid是一款基于Docker的命令行工具，旨在帮助用户在非Linux主机上使用LUKS加密分区镜像。通过容器化方式，无需在主机系统直接配置LUKS环境即可便捷操作加密镜像。

核心功能

• 创建LUKS加密分区镜像
• 挂载LUKS加密分区镜像至容器内
• 为LUKS加密分区镜像添加或删除额外密码

应用场景

• 快速查看LUKS加密分区备份内容
• 安全存储敏感数据为LUKS加密分区格式

技术规格

环境变量

无特殊环境变量需求

暴露端口

无端口暴露

数据卷

• /data: 工具查找LUKS加密分区镜像的目录，需将主机镜像目录挂载至此

内置组件

• Alpine Linux: 轻量级基础操作系统
• Cryptsetup and LUKS: 开源磁盘加密工具
• Ext文件系统工具: 文件系统管理工具
• Nano文本编辑器: 轻量级文本编辑工具

使用方法

前期准备

使用前建议创建命令别名，简化后续操作：

shell
IMAGES_PATH=/path/to/your/images  # 替换为本地镜像存放路径
alias luksoid='docker run --privileged=true --rm --interactive --tty --mount "type=bind,source=$IMAGES_PATH,target=/data" theanurin/luksoid'

挂载加密镜像

将现有LUKS加密镜像挂载至容器内进行读写操作：

shell
luksoid mount my-sensitive-luks.img

操作示例输出：

检查空闲循环设备... 完成。

将文件 '/data/my-sensitive-luks.img' 附加到 /dev/loop0... 完成。

正在打开LUKS。请输入密码。
Enter passphrase for /data/my-sensitive-luks.img: 
LUKS打开完成。

正在挂载LUKS加密分区上的文件系统...
文件系统已挂载至 '/mnt'。

欢迎使用！

LUKS加密分区内容位于 /mnt 目录。

可在 /mnt 目录下自由读写文件。

[!] 请务必使用 'exit' 命令正常退出，以防止镜像文件 'my-sensitive-luks.img' 损坏。

bash-5.1# echo "我的敏感数据" >> secret.txt
bash-5.1# exit
exit

卸载 '/mnt'... 完成。
关闭LUKS... 完成。
释放 /dev/loop0... 完成。

初始化加密镜像

创建新的LUKS加密分区镜像：

shell
luksoid init --sizemb=256 --fstype=vfat my-sensitive-luks.img  # --sizemb指定大小(MB)，--fstype指定文件系统类型

操作示例输出：

正在为256 MB初始化零填充文件 '/data/my-sensitive-luks.img'... 完成。

检查空闲循环设备... 完成。

将文件 '/data/my-sensitive-luks.img' 附加到 /dev/loop1... 完成。

正在格式化LUKS。请输入密码。文件 '/data/my-sensitive-luks.img' 中的所有数据将被清除！！！
Enter passphrase for /data/my-sensitive-luks.img:
LUKS格式化完成。

正在打开LUKS。请再次输入密码，以验证密码并创建'vfat'文件系统。
Enter passphrase for /data/my-sensitive-luks.img:
LUKS打开完成。

向LUKS加密分区写入零数据，确保外部无法识别使用模式... 完成。

正在LUKS加密分区上创建'vfat'文件系统...
设备 '/dev/mapper/uncrypted-loop1':
磁头:255, 每磁道扇区:63, 每扇区字节:512
媒体描述符:f8
总扇区:491520, 簇:483952, 每簇扇区:1
FAT数量:2, 每FAT扇区:3781
卷ID:61cdcedb, 卷标:''
文件系统创建完成。

关闭LUKS... 完成。
释放 /dev/loop1... 完成。

密码管理

LUKS支持最多8个密码槽，允许使用不同独立密码解密同一镜像，便于多用户共享或密码更新。

添加新密码

shell
luksoid passphrase-add my-sensitive-luks.img

操作示例输出：

检查空闲循环设备... 完成。

将文件 '/data/my-sensitive-luks.img' 附加到 /dev/loop0... 完成。

正在添加新密码（用于生成新密钥）...

输入任意现有密码:
输入新密码槽密码:
验证密码:

LUKS密码添加完成。

释放 /dev/loop0... 完成。

删除密码

shell
luksoid passphrase-remove my-sensitive-luks.img

操作示例输出：

检查空闲循环设备... 完成。

将文件 '/data/my-sensitive-luks.img' 附加到 /dev/loop0... 完成。

正在删除密码...

输入要删除的密码:

LUKS密码删除完成。

释放 /dev/loop0... 完成。