快速上手

三步开始使用 Flameshot

安装完成后,只需简单的三步配置,即可开启你的高效截图工作流。

安装 Flameshot

前往下载中心选择适合你操作系统的安装包。Windows 用户运行 EXE 安装包即可,macOS 用户可使用 DMG 或 Homebrew 安装,Linux 用户可使用包管理器或 AppImage。

设置全局快捷键

建议绑定全局快捷键到易于触达的组合键(如 Ctrl + Alt + A),让你可以在任何应用中一键唤起截图模式。在系统设置中配置对应的全局快捷键即可。

开始截图并标注

按下快捷键启动 Flameshot,鼠标拖拽选择截图区域,松开鼠标后自动进入编辑模式。使用左侧工具栏选择标注工具,完成后点击底部按钮保存、复制或上传图床。

快捷键速查

编辑模式中的快捷键

在截图编辑界面中,熟练使用快捷键可以让你的标注效率成倍提升。以下是默认快捷键配置,所有快捷键均可在设置中自定义。

标注工具切换

快捷键 功能说明
P画笔工具 - 自由手绘
A箭头工具 - 指向标注
T文本工具 - 添加文字
R矩形工具 - 矩形框选
O圆形工具 - 圆形标注
L直线工具 - 绘制直线
M马赛克工具 - 模糊遮盖
C序号计数器 - 自动编号

操作与输出

快捷键 功能说明
Ctrl + S保存到本地文件
Ctrl + C复制到剪贴板
Ctrl + Z撤销上一步操作
Ctrl + Y重做已撤销操作
Ctrl + U上传到 Imgur 图床
Space钉图悬浮到桌面
Esc退出截图模式
Enter确认完成截图

提示:在截图选择区域时,按住 Shift 可锁定为正方形选区,按住 Ctrl 可移动选区位置而非改变大小。在 macOS 上,使用 Cmd 替代 Ctrl

命令行进阶

命令行自动化截图

Flameshot 提供完善的命令行接口,让你可以将截图能力集成到 Shell 脚本、CI/CD 流水线、自动化测试中,实现真正的无人值守截图工作流。

基础命令

以下为最常用的 Flameshot 命令行用法,覆盖日常截图的全部需求。所有命令均可在终端直接执行,无需 root 权限。

# 启动 GUI 模式(最常用)
flameshot gui

# 全屏截图并保存到指定路径
flameshot full --path ~/Pictures/screenshot.png

# 全屏截图并复制到剪贴板
flameshot full --clipboard

# 捕获当前活动窗口
flameshot active --path ~/Pictures/

延时截图

延时截图适合捕获需要触发后才出现的菜单、弹窗或动画状态。延时参数以毫秒为单位,可精确控制延迟时间。

# 延时 5 秒后全屏截图
flameshot full --delay 5000

# 延时 2 秒后启动 GUI 模式
flameshot gui --delay 2000

上传图床

截图后自动上传到 Imgur 图床,并获取分享链接。配合命令行参数可完全自动化整个流程,无需人工干预。

# 截图并上传到 Imgur
flameshot full --upload

# 截图后既保存到本地又上传图床
flameshot full --path ~/Pictures/ --upload

批量自动化示例

以下 Shell 脚本演示如何利用 Flameshot 实现定时截图自动化,可用于服务器监控、长时间任务记录等场景。配合 cron 定时任务,即可打造完整的自动化截图系统。

#!/bin/bash
# 自动化截图脚本:每小时捕获一次屏幕状态

TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
SAVE_DIR=~/Pictures/auto_screenshots/
mkdir -p "$SAVE_DIR"

flameshot full --path "${SAVE_DIR}screen_${TIMESTAMP}.png"

echo "截图已保存:${SAVE_DIR}screen_${TIMESTAMP}.png"
配置文件

高级配置与自定义

除了图形界面设置,Flameshot 还提供配置文件机制,方便高级用户进行深度定制与多设备同步。

配置文件位置

Flameshot 的配置文件采用标准 INI 格式,可使用任意文本编辑器修改。配置文件位置因平台而异,具体路径如下:

# Linux
~/.config/flameshot/flameshot.ini

# macOS
~/Library/Preferences/flameshot.ini

# Windows
%APPDATA%/flameshot/flameshot.ini

多设备配置同步

配置文件可导入导出,方便在多台设备间同步你的 Flameshot 设置。建议将配置文件纳入 dotfiles 仓库管理,配合 Git 即可实现版本控制与跨设备同步。导出配置:在设置界面点击"导出配置"按钮,或直接复制配置文件到目标设备即可。

自定义颜色主题

颜色面板支持完全自定义,你可以添加常用颜色到面板中,或导入预设的主题色彩方案。在配置文件中的 [Colors] 段可手动编辑颜色值,支持 HEX 与 RGB 格式。预设主题包可从社区获取。

DBus 接口(Linux 专属)

在 Linux 平台,Flameshot 提供 DBus 接口,允许其他应用程序通过 DBus 调用截图功能。这为编写自定义集成脚本、桌面环境扩展提供了强大支持。通过 dbus-send 或 qdbus 命令即可远程调用 Flameshot 的所有功能。

常见问题

用户最关心的问题解答

我们整理了用户最常提出的问题与解答,如果你的问题没有在此列出,欢迎前往 GitHub Issues 反馈。

Flameshot 完全免费开源,基于 GPLv3 协议发布。无论是个人使用、教育用途还是企业部署,都无需支付任何费用,也没有功能限制、广告植入或付费版本的概念。所有功能对所有用户完全开放,源代码也完全公开在 GitHub 上,欢迎审查、修改与贡献。

Flameshot 原生支持三大主流操作系统:Windows 10/11 64-bit、macOS 11 Big Sur 及以上版本(支持 Intel 与 Apple Silicon)、以及各大主流 Linux 发行版(包括 Ubuntu、Fedora、Arch Linux、Manjaro、openSUSE 等)。对于 Linux 用户,我们还提供 AppImage、Flatpak、Snap 等通用安装格式,覆盖几乎所有现代 Linux 发行版。

Flameshot 支持完全自定义快捷键。打开 Flameshot 配置界面(右键托盘图标选择"配置"),进入"快捷键"标签页,即可为截图触发、工具切换、保存上传等所有行为绑定自定义快捷键。配置文件支持导入导出,方便在多台设备间同步设置。系统级全局快捷键需要在操作系统的快捷键设置中配置(如 Windows 设置 → 辅助功能 → 键盘,或 macOS 系统偏好设置 → 键盘 → 快捷键)。

支持。从 v12.0 版本开始,Flameshot 已经对 Wayland 显示服务器提供原生兼容支持。在 GNOME、KDE Plasma 等主流 Wayland 桌面环境下均可正常使用所有截图与编辑功能。由于 Wayland 的安全模型限制,部分 Wayland 合成器可能需要额外的权限配置才能使用全局快捷键,具体配置方法请参考 GitHub Wiki 中的 Wayland 集成指南。

Flameshot 内置 Imgur 图床上传支持。如需上传到自定义图床或服务器,可以通过配置脚本的方式实现:在 Flameshot 配置中的"上传"标签页,可以指定上传后调用的外部脚本路径。Flameshot 会将截图文件路径作为参数传递给脚本,由脚本完成上传逻辑并返回分享链接。社区已有多种图床的集成脚本可供参考,包括腾讯云 COS、阿里云 OSS、七牛云等国内图床服务。

Flameshot 原生支持多显示器环境。启动 GUI 模式后,你可以跨多屏拖拽选择截图区域,或在任意单个屏幕上框选。对于全屏截图命令,可通过 --screen 参数指定要捕获的显示器序号。在高 DPI 显示器环境下,Flameshot 会自动适配系统缩放比例,确保截图清晰度。如遇多显示器缩放比例不一致的情况,建议在系统设置中统一缩放比例。

Flameshot 不收集任何用户隐私数据。作为开源软件,所有代码均公开在 GitHub 上,社区可以审查代码确认无任何遥测、追踪或数据上传行为。所有截图处理均在本地完成,上传到图床的操作仅在用户主动触发时才会执行,且上传的目标地址完全透明可见。我们高度重视用户隐私,这也是 Flameshot 始终坚持开源的核心原因之一。

欢迎前往 GitHub Issues 页面提交 Bug 报告或功能建议。提交 Bug 时请尽量提供以下信息:操作系统版本、Flameshot 版本、问题复现步骤、相关截图或日志。这些信息能帮助开发者更快定位问题。功能建议请详细描述使用场景与期望效果。社区非常欢迎新贡献者,无论是代码贡献、文档完善、翻译本地化还是问题解答,都是对项目的有力支持。

准备好动手试试了吗?

立即下载 Flameshot,按照教程配置你的高效截图工作流。

立即下载 完整文档