Ubuntu 安装与配置 Snipaste 指令整理#

适用场景：

Ubuntu 22.04 / 24.04
Snipaste Linux AppImage
软件统一放在 /home/daisy/Software/
Snipaste 目录为 /home/daisy/Software/Snipaste/

1. 创建 Snipaste 专属目录#

1
mkdir -p /home/daisy/Software/Snipaste

查看当前下载的 Snipaste AppImage：

1
find /home/daisy/Software -maxdepth 1 -type f -iname '*snipaste*.AppImage' -print

示例输出：

1
/home/daisy/Software/Snipaste-2.11.3-x86_64.AppImage

将 AppImage 移动到独立目录，并统一改名：

1
mv /home/daisy/Software/*[Ss]nipaste*.AppImage \
2
   /home/daisy/Software/Snipaste/Snipaste.AppImage

赋予执行权限：

1
chmod +x /home/daisy/Software/Snipaste/Snipaste.AppImage

2. 安装 AppImage 所需的 FUSE 运行库#

如果运行 Snipaste 时出现：

1
dlopen(): error loading libfuse.so.2

说明系统缺少 FUSE 兼容库。

执行：

1
sudo apt update

Ubuntu 24.04：

1
sudo apt install -y libfuse2t64

Ubuntu 22.04：

1
sudo apt install -y libfuse2

也可以使用自动判断命令：

1
if apt-cache show libfuse2t64 >/dev/null 2>&1; then
2
    sudo apt install -y libfuse2t64
3
else
4
    sudo apt install -y libfuse2
5
fi

检查 libfuse.so.2 是否已经安装：

1
ldconfig -p | grep libfuse.so.2

3. 直接启动 Snipaste#

前台启动：

1
/home/daisy/Software/Snipaste/Snipaste.AppImage

注意：

Snipaste 启动后通常不会弹出普通主窗口。
程序会驻留后台或系统托盘。
终端一直不返回提示符，通常表示程序正在前台运行，并不代表卡死。

停止前台进程：

1
Ctrl + C

4. 后台启动 Snipaste#

推荐命令：

1
nohup /home/daisy/Software/Snipaste/Snipaste.AppImage \
2
  >/tmp/snipaste.log 2>&1 </dev/null &
3
disown

查看 Snipaste 是否正在运行：

1
pgrep -af Snipaste

查看运行日志：

1
cat /tmp/snipaste.log

如果日志中只有：

1
nohup: 忽略输入

这不是报错，只表示程序不再读取终端输入。

结束 Snipaste 进程：

1
pkill -f Snipaste

5. 使用命令直接触发截图#

如果 Snipaste 已经可以运行，但 F1 快捷键无效，可以直接使用：

1
/home/daisy/Software/Snipaste/Snipaste.AppImage snip

该命令能够正常进入截图界面，说明：

Snipaste 本体安装正常；
AppImage 可以正常运行；
问题主要是全局快捷键没有生效。

6. 创建 Ubuntu 应用菜单入口#

创建应用菜单目录：

1
mkdir -p ~/.local/share/applications

创建 Snipaste 启动器：

1
cat > ~/.local/share/applications/snipaste.desktop <<'EOF'
2
[Desktop Entry]
3
Version=1.0
4
Type=Application
5
Name=Snipaste
6
Name[zh_CN]=Snipaste 截图
7
Comment=Screenshot and pin images
8
Comment[zh_CN]=截图、标注和贴图工具
9
Exec=/home/daisy/Software/Snipaste/Snipaste.AppImage
10
Icon=camera-photo
11
Terminal=false
12
Categories=Graphics;Utility;
13
StartupNotify=false
14
EOF

赋予启动器执行权限：

1
chmod +x ~/.local/share/applications/snipaste.desktop

刷新应用菜单数据库：

1
update-desktop-database ~/.local/share/applications 2>/dev/null

之后按 Super 键，在应用菜单搜索：

1
Snipaste

7. 设置 Snipaste 开机自启动#

创建自启动目录：

1
mkdir -p ~/.config/autostart

创建自启动文件：

1
cat > ~/.config/autostart/snipaste.desktop <<'EOF'
2
[Desktop Entry]
3
Type=Application
4
Name=Snipaste
5
Comment=Start Snipaste at login
6
Exec=/home/daisy/Software/Snipaste/Snipaste.AppImage
7
Terminal=false
8
X-GNOME-Autostart-enabled=true
9
StartupNotify=false
10
EOF

检查自启动文件：

1
cat ~/.config/autostart/snipaste.desktop

重新登录 Ubuntu 后，检查是否自动运行：

1
pgrep -af Snipaste

8. 设置 Ubuntu 系统快捷键#

在 Ubuntu 中打开：

1
设置
2
→ 键盘
3
→ 查看及自定义快捷键
4
→ 自定义快捷键

添加以下快捷键：

1
名称：Snipaste 截图
2
命令：/home/daisy/Software/Snipaste/Snipaste.AppImage snip
3
快捷键：Ctrl + Shift + A

推荐使用：

1
Ctrl + Shift + A

不建议继续使用 F1，原因包括：

Ubuntu 或 GNOME 可能占用 F1；
笔记本电脑可能需要同时按 Fn；
Wayland 对应用程序全局快捷键有限制。

9. 检查 Ubuntu 使用 Wayland 还是 X11#

执行：

1
echo $XDG_SESSION_TYPE

可能输出：

1
wayland

或：

1
x11

如果是 Wayland，Snipaste 自带的全局快捷键可能无法生效。

可以尝试通过 XWayland 启动：

1
QT_QPA_PLATFORM=xcb \
2
/home/daisy/Software/Snipaste/Snipaste.AppImage

后台启动方式：

1
nohup env QT_QPA_PLATFORM=xcb \
2
  /home/daisy/Software/Snipaste/Snipaste.AppImage \
3
  >/tmp/snipaste.log 2>&1 </dev/null &
4
disown

10. 修改应用菜单启动器为 XWayland 模式#

如果普通启动存在 Wayland 兼容问题，可以修改：

1
sed -i \
2
's|^Exec=.*|Exec=env QT_QPA_PLATFORM=xcb /home/daisy/Software/Snipaste/Snipaste.AppImage|' \
3
~/.local/share/applications/snipaste.desktop

刷新菜单：

1
update-desktop-database ~/.local/share/applications 2>/dev/null

11. AppImage 无法直接运行时解压使用#

进入 Snipaste 目录：

1
cd /home/daisy/Software/Snipaste

解压 AppImage：

1
./Snipaste.AppImage --appimage-extract

重命名解压目录：

1
mv squashfs-root app

运行解压后的程序：

1
/home/daisy/Software/Snipaste/app/AppRun

如果解压后的版本可以运行，可将应用菜单启动器改为：

1
sed -i \
2
's|^Exec=.*|Exec=/home/daisy/Software/Snipaste/app/AppRun|' \
3
~/.local/share/applications/snipaste.desktop

12. 检查系统和文件架构#

查看系统架构：

1
uname -m

常见正常输出：

1
x86_64

检查 Snipaste AppImage 文件类型：

1
file /home/daisy/Software/Snipaste/Snipaste.AppImage

如果系统是：

1
aarch64

或：

1
arm64

则 x86_64 版本的 Snipaste AppImage 不能直接运行。

13. 常用指令速查#

启动 Snipaste：

1
/home/daisy/Software/Snipaste/Snipaste.AppImage

后台启动：

1
nohup /home/daisy/Software/Snipaste/Snipaste.AppImage \
2
  >/tmp/snipaste.log 2>&1 </dev/null &
3
disown

触发截图：

1
/home/daisy/Software/Snipaste/Snipaste.AppImage snip

检查进程：

1
pgrep -af Snipaste

查看日志：

1
cat /tmp/snipaste.log

结束进程：

1
pkill -f Snipaste

检查桌面环境：

1
echo $XDG_SESSION_TYPE

检查系统架构：

1
uname -m

刷新应用菜单：

1
update-desktop-database ~/.local/share/applications 2>/dev/null

14. 当前推荐配置#

当前机器建议使用以下组合：

1
Snipaste 路径：
2
/home/daisy/Software/Snipaste/Snipaste.AppImage
3

4
开机自启动：
5
~/.config/autostart/snipaste.desktop
6

7
应用菜单入口：
8
~/.local/share/applications/snipaste.desktop
9

10
系统截图快捷键：
11
Ctrl + Shift + A
12

13
截图命令：
14
/home/daisy/Software/Snipaste/Snipaste.AppImage snip

使用流程：

1
登录 Ubuntu
2
→ Snipaste 自动在后台运行
3
→ 按 Ctrl + Shift + A
4
→ 开始截图

管理主页分类