Himalaya 命令行邮件客户端安装指南

Himalaya 是一款基于 Rust 开发的高效命令行邮件客户端，提供多账户管理、IMAP 协议支持和丰富的邮件操作功能。本指南将根据不同用户场景，帮助你选择最适合的安装方式，快速上手这款强大的邮件工具。

新手友好方案

一键脚本安装

适用人群：初次接触命令行工具的用户、希望快速体验的新手、跨平台用户

这种方式通过官方安装脚本自动完成环境检测和二进制文件部署，无需手动配置依赖。

系统级安装（需要管理员权限）：

curl -sSL https://raw.githubusercontent.com/pimalaya/himalaya/master/install.sh | sudo sh

该命令会将 Himalaya 安装到系统默认路径（通常为 /usr/local/bin），所有用户均可使用

用户级安装（无需管理员权限）：

curl -sSL https://raw.githubusercontent.com/pimalaya/himalaya/master/install.sh | PREFIX=~/.local sh

安装完成后需确保 ~/.local/bin 已添加到环境变量 PATH 中

注意事项：

• 安装前请确保系统已安装 curl 工具
• Windows 用户需要在 WSL 或 MSYS2 环境下运行此脚本
• 脚本会自动下载对应系统架构的最新稳定版二进制文件

开发者定制方案

Cargo 包管理器安装

适用人群：Rust 开发者、需要自定义编译选项的高级用户、希望体验最新功能的测试者

如果你已安装 Rust 开发环境（1.60.0 或更高版本），可以通过 Cargo 直接安装：

标准安装（全功能版）：

cargo install himalaya

最小化安装（仅 IMAP 支持）：

cargo install himalaya --no-default-features --features imap

开发版安装（最新代码）：

cargo install --frozen --force --git https://gitcode.com/gh_mirrors/hi/himalaya

--force 参数会覆盖已安装版本，--frozen 确保依赖版本与 Cargo.lock 一致

注意事项：

• 编译过程需要 5-10 分钟，取决于网络和硬件性能
• 开发版可能包含未稳定的功能，不建议用于生产环境
• 如需自定义功能，请克隆仓库后修改 Cargo.toml 再编译

系统原生集成

Linux 发行版包管理器

适用人群：Linux 桌面用户、偏好系统原生包管理的用户、需要自动更新的场景

Arch Linux

# 社区仓库稳定版
pacman -S himalaya

# AUR 开发版
yay -S himalaya-git

Fedora/CentOS/RHEL

dnf copr enable atim/himalaya
dnf install himalaya

注意事项：

• Arch 用户需确保 AUR 助手已正确配置
• Fedora 用户需要先启用 COPR 仓库
• 发行版仓库版本可能滞后于官方最新版

macOS Homebrew

适用人群：macOS 用户、习惯使用 Homebrew 管理软件的用户

brew install himalaya

注意事项：

• 确保 Homebrew 已正确安装并更新：brew update
• 通过 Homebrew 安装的版本通常为稳定版
• 如需开发版可使用 brew install --HEAD himalaya

Windows Scoop

适用人群：Windows 用户、偏好命令行包管理的 Windows 高级用户

scoop install himalaya

注意事项：

• 需要先安装 Scoop 包管理器
• 可能需要在 PowerShell 中执行
• 确保已添加相应的软件源：scoop bucket add extras

安装后验证

🔍 验证安装是否成功：

himalaya --version

成功安装会显示版本信息，例如：himalaya 0.9.0

🔍 验证命令可用性：

himalaya --help

成功执行会显示完整的命令帮助文档，包含所有可用子命令和选项。

快速配置向导

安装完成后，启动配置向导设置你的第一个邮件账户：

himalaya

按照提示输入邮件服务器信息、用户名和密码。你也可以手动配置：

cp config.sample.toml ~/.config/himalaya/config.toml

然后使用文本编辑器修改配置文件。

Himalaya 的邮件列表界面如下所示：

基础使用命令

• 查看收件箱邮件：himalaya envelope list
• 配置新账户：himalaya account configure <账户名>
• 读取邮件内容：himalaya message read <邮件ID>
• 发送新邮件：himalaya message send
• 查看帮助信息：himalaya --help

版本选择建议

• 稳定版：适合大多数用户，通过包管理器或官方脚本安装的默认版本
• 开发版：适合希望体验最新功能的技术爱好者，需通过 Cargo 或 AUR 安装
• 特定版本：企业用户或需要稳定性的场景，可指定版本号安装：cargo install himalaya --version 0.8.0

常见问题解决

1. 命令未找到 (command not found)

解决方法：

• 检查安装路径是否已添加到环境变量 PATH
• 用户级安装需执行：export PATH=$HOME/.local/bin:$PATH
• 或添加到 .bashrc 或 .zshrc 中永久生效

2. 编译失败 (Cargo build error)

解决方法：

• 更新 Rust 工具链：rustup update
• 安装系统依赖：sudo apt install libssl-dev (Debian/Ubuntu) 或 sudo dnf install openssl-devel (Fedora)

3. 邮件服务器连接失败

解决方法：

• 检查配置文件中的服务器地址和端口是否正确
• 常见 IMAP 端口：143 (明文)、993 (SSL)
• 尝试启用调试模式查看详细日志：RUST_LOG=debug himalaya envelope list

4. 安装脚本被系统阻止

解决方法：

• 检查网络连接和防火墙设置
• 手动下载安装脚本检查内容：curl -sSL https://raw.githubusercontent.com/pimalaya/himalaya/master/install.sh -o install.sh
• 查看脚本无问题后执行：sh install.sh

5. 配置文件权限问题

解决方法：

• 确保配置文件权限正确：chmod 600 ~/.config/himalaya/config.toml
• 避免将配置文件设置为全局可读，保护账户信息安全