shpool 项目安装与配置指南

shpool 项目安装与配置指南

shpool Think tmux, then aim... lower 项目地址: https://gitcode.com/gh_mirrors/sh/shpool

一、项目基础介绍

shpool 是一个开源项目，旨在提供会话持久化功能。它允许用户创建由 shpool 管理的命名 shell 会话，即使连接断开，会话也不会丢失。与 tmux 或 GNU screen 不同，shpool 不会接管整个终端，也不提供窗口分割和布局功能，它仅提供会话持久化。这种方法的优点是 shpool 不会破坏原生滚动条或复制粘贴功能。

二、项目使用的关键技术和框架

• Rust：shpool 是使用 Rust 编程语言编写的，Rust 是一种系统编程语言，注重安全、性能和并发。
• systemd：项目支持使用 systemd 来运行守护进程，systemd 是一个系统和服务管理器，用于 Linux 操作系统。

三、安装和配置准备工作

在开始安装 shpool 之前，请确保您的系统满足以下要求：

1. 安装 Rust 编程语言环境。
2. 确保您的系统支持 systemd（对于 Linux 发行版通常默认支持）。

安装 Rust

1. 访问 Rust 官方网站 按照指南安装 Rust。
2. 安装完成后，打开终端并运行 rustc --version 和 cargo --version 来确认安装成功。

安装 systemd

对于大多数现代 Linux 发行版，systemd 已预装。如果没有安装，您可以通过发行版的包管理器进行安装。

详细安装步骤

使用 systemd 安装

1. 在终端中运行以下命令来安装 shpool：

   cargo install shpool
   

2. 下载并配置 systemd 服务文件：

   curl -fLo "${XDG_CONFIG_HOME:-$HOME/.config}/systemd/user/shpool.service" --create-dirs https://raw.githubusercontent.com/shell-pool/shpool/master/systemd/shpool.service
   sed -i "s|/usr|$HOME/.cargo|" "${XDG_CONFIG_HOME:-$HOME/.config}/systemd/user/shpool.service"
   curl -fLo "${XDG_CONFIG_HOME:-$HOME/.config}/systemd/user/shpool.socket" --create-dirs https://raw.githubusercontent.com/shell-pool/shpool/master/systemd/shpool.socket
   

3. 启用并启动 shpool 服务：

   systemctl --user enable shpool
   systemctl --user start shpool
   loginctl enable-linger
   

不使用 systemd 安装

如果您的系统不支持 systemd 或您选择不使用 systemd，可以按以下步骤安装：

cargo install shpool

在这种情况下，shpool 会默认启用自动守护进程模式。

使用 shpool

安装并配置完成后，可以通过以下方式使用 shpool：

• 创建并附加到新的命名会话：

  shpool attach main
  

• 如果连接断开，重新 SSH 到远程主机，并重新附加到会话：

  shpool attach main
  

• 如果终端卡住，您可以通过以下命令强制会话分离：

  shpool detach main
  

请参考项目 README 和 wiki 获取更多使用技巧和故障排除信息。

shpool Think tmux, then aim... lower 项目地址: https://gitcode.com/gh_mirrors/sh/shpool