Ciphey Releases Rust-Based Auto-Decoder Tool

By bee-sanOriginal title: ⭐ bee-san/Ciphey (21662 stars)
68AI Score

Open-source project Ciphey has released a Rust-based rewrite that automatically decodes multi-layered encoded or encrypted text without requiring keys or hints. Supporting over 20 formats including Base64 and Vigenère, it offers CLI, library, and MCP integrations to enhance decryption efficiency in security research and CTF scenarios.

Related Entities

Full Report

Contents5 sections

粘贴经过编码或加密的文本。Ciphey 会自动识别其方式并输出明文。无需密钥、密码名称或任何提示。支持 Base64、十六进制、凯撒/ROT13、维吉尼亚密码、摩尔斯电码以及另外 19 种格式,且可处理多层嵌套。

安装 · 快速开始 · 功能特性 · 库 · MCP · 文档 · Discord ▶ 观看一分钟导览 (MP4, 61 s)

安装

BASH
cargo install ciphey

Linux (x86_64)、macOS (Intel 和 Apple silicon) 以及 Windows (x86_64) 的预编译二进制文件可在 发布页面 获取,每个文件均附带 .sha256 校验和。

若要从源码构建,你需要 Rust 工具链:

BASH
git clone https://github.com/bee-san/Ciphey
cd Ciphey
cargo build --release    # 生成的二进制文件位于 target/release/ciphey

或者跳过安装步骤:加入 Discord 服务器,进入 #bots 频道并输入 $ciphey <你的文本>(输入 $help 可查看命令列表)。

快速开始

BASH
$ ciphey -t 'aGVsbG8gdGhlcmUgZ2VuZXJhbA=='
🕵️ 我认为明文是 Words.
可能的明文: 'hello there general' (y/N):
y

🥳 ciphey 已解码 64 次。

明文为:
hello there general
使用的解码器是 Base64

首次运行时,简短的设置向导会询问你偏好的颜色主题、结果展示方式以及是否使用词表,并将你的选择保存到 ~/.ciphey/config.toml。

BASH
ciphey -t 'NTA3NjYzNzU3MjZjMjA3NjY2MjA2OTcyNjU2YzIwNzM2ZTY2Njc='   # ROT13 → hex → Base64,无需其他配置
ciphey -f secret.txt                    # 从文件读取输入
ciphey -d -t '...'                      # 无 y/N 提示:直接采用找到的第一个明文(便于脚本使用)
ciphey -c 15 -t '...'                   # 持续搜索最多 15 秒(默认为 5 秒)
ciphey -r 'flag\{' -t '...'             # 仅接受匹配特定正则表达式的明文(即 crib)
ciphey --wordlist words.txt -t '...'    # 同时接受来自词表的任何精确匹配项

运行 ciphey --help 可列出所有选项。

功能特性

⚡ 快速

<img src="https://cdn.jsdelivr.net/gh/bee-san/Ciphey@d41d19946234477346fede14dadf8c351cc469e6/media/tui-video/out/fast.gif" alt="终端运行 time ciphey -d 处理一个 Base64 字符串。Ciphey 打印出 'Ciphey is very fast' 以及解码路径 Base64 → Hexadecimal → caesar,bash 报告 real 0m0.157s。随后图表对比了 Ciphey 的 0.19 s(10 次运行的中位数)与 Python Ciphey 5.14.0 在相同输入下超过 60 s 仍无结果的情况。">

<sub>▶ 观看视频片段 (16 s)</sub>

三层编码(ROT13、十六进制、Base64)在 0.16 秒内被逐层剥离,这是通过 bash 的 time 命令在实际录制中测得的结果。以下是针对更多输入的相同对比测试,对照版本为 Python Ciphey 5.14(即 Ciphey 所替代的版本):

输入CipheyPython Ciphey 5.14
Base640.11 s0.92 s
Hex → Base640.14 s1.02 s
ROT13 → Hex → Base640.19 s60 s 内无结果
URL → Base64 → Hex0.24 s1.15 s
Base64 ×40.41 s0.78 s
Hex → Base32 → Base64 → Hex0.54 s0.72 s,答案错误
ROT13 → Hex → Base64 → Base321.15 s60 s 内无结果

<sub>每个输入进行 10 次运行取墙钟时间中位数(Python Ciphey 为 3 次),测试环境为一台共享的 16 核 Linux 机器。Ciphey 版本为 47bd16d6,关闭了 y/N 提示,且每次运行使用全新的 <code>$HOME</code> 以确保缓存不生效。所有运行均限制在 60 秒以内。脚本和原始数据位于 <code>media/tui-video/bench</code> 目录下的 <code>media/readme-videos</code> 分支。</sub>

在两者都能得到正确答案的情况下,Ciphey 的速度快 1.9 到 8.6 倍。速度优势从何而来?

  • 它是用 Rust 编写的。
  • A* 搜索算法优先尝试最有希望的解码器链。
  • 每个解码器都通过 Rayon 并行运行,同时处理最多 10 个候选文本。
  • 答案缓存在 ~/.ciphey/database.sqlite 中,因此第二次遇到相同输入时可在毫秒级返回结果。

🧅 逐层剥离,无需密钥

Ciphey 无需被告知它正在处理什么。它会搜索解码器链(例如 Base64 嵌套在十六进制中,再嵌套在 ROT13 中;或者四层 Base64 等),并在遇到第一个看起来像明文的候选结果时停止。默认情况下,它会显示该候选结果,并在接受之前询问用户(使用 -d 可关闭此功能)。本页顶部的演示片段展示了一个四层解码过程。

此外还有一个计时器:如果 Ciphey 在 5 秒内未找到任何结果,它将停止并报告这一情况(使用 -c 可更改时间限制)。

它支持 24 种解码器和破解器:

类型解码器
Base 编码Base64(标准及 URL-safe 变体)、Base32、Base58(Bitcoin, Flickr, Monero, Ripple)、Base91、Base65536、Z85
其他编码十六进制、二进制、URL(百分号编码)、摩尔斯电码、盲文、A1Z26、Citrix CTX1
密码凯撒密码(包括 ROT13)、ROT47、Atbash、维吉尼亚密码(自动推导密钥)、栅栏密码、反转文本
特殊项Brainfuck(直接运行程序)、使用其他符号书写的摩尔斯电码或二进制

更多功能即将推出:#1030 跟踪了尚未集成的 109 种解码器。

(注:更多技术实现细节与完整 API 文档请查阅原项目 README)