Ogulcan Celik
parent
0cd0b1aef0
commit
3661d99c2e
|
|
@ -0,0 +1,62 @@
|
|||
---
|
||||
title: トラブルシューティング
|
||||
description: インストール、ターミナル入力、セッション、キーバインド、リモート接続の一般的な問題を診断します。
|
||||
---
|
||||
|
||||
まずバージョンとセッション状態を確認します:
|
||||
|
||||
```bash
|
||||
herdr -V
|
||||
herdr status
|
||||
```
|
||||
|
||||
OS、外側のターミナル名とバージョン、ローカルまたはリモートのどちらか、tmux を使用しているかも記録してください。
|
||||
|
||||
## Enter、Tab、Backspace が 2 回入力される
|
||||
|
||||
古いターミナルでは、アプリケーションが Kitty キーボードイベント報告を有効にすると、Enter、Tab、Backspace のリリースをプレスと同じバイトとして送ることがあります。送信後は Herdr から重複したバイトを区別できません。
|
||||
|
||||
上流の修正を含むバージョンへ外側のターミナルを更新してください:
|
||||
|
||||
| ターミナル | 修正済みの最小バージョン |
|
||||
| --- | --- |
|
||||
| kitty | 0.33.0 |
|
||||
| foot | 1.20.0 |
|
||||
| Alacritty | 0.15.0 |
|
||||
|
||||
長期サポート版 Linux ディストリビューションの古いターミナルパッケージで特に発生します。確認済みの境界キャプチャと上流参照は [Herdr issue #1116](https://github.com/ogulcancelik/herdr/issues/1116) を参照してください。現在のターミナルでも発生する場合は、正確なバージョンと Herdr の外でも発生するかを報告してください。
|
||||
|
||||
## Herdr を更新したのに実行中のセッションが古い
|
||||
|
||||
バイナリを更新しても、互換性のある実行中サーバーは自動で置き換わらないことがあります。`herdr status` を確認してください。更新済みサーバーを起動するには、セッションを停止して Herdr を再起動します:
|
||||
|
||||
```bash
|
||||
herdr server stop
|
||||
herdr
|
||||
```
|
||||
|
||||
サーバーを停止するとペインのプロセスも終了します。名前付きセッションでは `herdr session stop <name>` を使います。更新機能、パッケージマネージャー、ライブハンドオフについては[インストール](/ja/docs/install/#update)を参照してください。
|
||||
|
||||
## `herdr` コマンドが見つからない
|
||||
|
||||
ターミナルを再起動して環境を読み込み直し、Herdr のインストール先が `PATH` に含まれていることを確認してください。パッケージマネージャー経由のインストールは、そのパッケージマネージャーから更新して公開する必要があります。[インストール](/ja/docs/install/#verify)を参照してください。
|
||||
|
||||
## 直接キーバインドが動作しない
|
||||
|
||||
OS または外側のターミナルが Herdr に届く前にキーを処理している可能性があります。そのレイヤーでキーを解放するか、別のバインドを選んでください。既知の競合と安全なデフォルトは[キーボード](/ja/docs/keyboard/#going-prefix-free)を参照してください。
|
||||
|
||||
## リモートアタッチで認証できない
|
||||
|
||||
まず `ssh <host>` で通常の OpenSSH 接続が動作することを確認してください。非対話シェル、CI、モバイルターミナルでパスフレーズ付きキーを使う場合は、リモートアタッチの前にキーを `ssh-agent` へ読み込んでください。[永続化とリモートアクセス](/ja/docs/persistence-remote/#remote-attach-over-ssh)を参照してください。
|
||||
|
||||
## 診断ログを探す
|
||||
|
||||
Herdr のログはデフォルトで `~/.config/herdr/` にあります:
|
||||
|
||||
```text
|
||||
herdr.log
|
||||
herdr-client.log
|
||||
herdr-server.log
|
||||
```
|
||||
|
||||
詳細なログには `HERDR_LOG=herdr=debug` を設定します。問題を報告するときは現在のログとローテーション済みログを含めてください。[設定](/ja/docs/configuration/#logs)を参照してください。
|
||||
|
|
@ -0,0 +1,62 @@
|
|||
---
|
||||
title: Troubleshooting
|
||||
description: Diagnose common installation, terminal input, session, keybinding, and remote access problems.
|
||||
---
|
||||
|
||||
Start with the versions and session status:
|
||||
|
||||
```bash
|
||||
herdr -V
|
||||
herdr status
|
||||
```
|
||||
|
||||
Also record your operating system, outer terminal name and version, whether the session is local or remote, and whether tmux is involved.
|
||||
|
||||
## Enter, Tab, or Backspace fires twice
|
||||
|
||||
Older terminal versions can emit the release of Enter, Tab, and Backspace as the same bytes as the press when an application enables Kitty keyboard event reporting. Herdr cannot distinguish those duplicate bytes after the terminal sends them.
|
||||
|
||||
Update the outer terminal to a version containing its upstream fix:
|
||||
|
||||
| Terminal | Minimum fixed version |
|
||||
| --- | --- |
|
||||
| kitty | 0.33.0 |
|
||||
| foot | 1.20.0 |
|
||||
| Alacritty | 0.15.0 |
|
||||
|
||||
This is especially common with older terminal packages from long-term-support Linux distributions. See [Herdr issue #1116](https://github.com/ogulcancelik/herdr/issues/1116) for the confirmed boundary captures and upstream references. If the problem remains on a current terminal version, report the exact terminal version and whether it also happens outside Herdr.
|
||||
|
||||
## Herdr updated, but the running session is still old
|
||||
|
||||
Updating the binary does not always replace a compatible server that is already running. Check `herdr status`. To start the updated server, stop the session and launch Herdr again:
|
||||
|
||||
```bash
|
||||
herdr server stop
|
||||
herdr
|
||||
```
|
||||
|
||||
Stopping a server exits its pane processes. Named sessions use `herdr session stop <name>`. See [Install Herdr](/docs/install/#update) for updater, package-manager, and live-handoff behavior.
|
||||
|
||||
## The `herdr` command is not found
|
||||
|
||||
Restart the terminal so it reloads its environment, then confirm the Herdr install directory is on `PATH`. Package-manager installs must be updated and exposed through that package manager. See [Install Herdr](/docs/install/#verify).
|
||||
|
||||
## A direct keybinding does nothing
|
||||
|
||||
The operating system or outer terminal may consume the chord before Herdr receives it. Free the chord in that layer or choose another binding. See [Keyboard](/docs/keyboard/#going-prefix-free) for known conflicts and safe defaults.
|
||||
|
||||
## Remote attach cannot authenticate
|
||||
|
||||
First confirm that normal OpenSSH works with `ssh <host>`. For a passphrase-protected key in a non-interactive shell, CI job, or mobile terminal, load the key into `ssh-agent` before starting remote attach. See [Persistence and remote access](/docs/persistence-remote/#remote-attach-over-ssh).
|
||||
|
||||
## Find diagnostic logs
|
||||
|
||||
Herdr logs live in `~/.config/herdr/` by default:
|
||||
|
||||
```text
|
||||
herdr.log
|
||||
herdr-client.log
|
||||
herdr-server.log
|
||||
```
|
||||
|
||||
Set `HERDR_LOG=herdr=debug` for more detail. Include the current log and rotated siblings when reporting a problem. See [Configuration](/docs/configuration/#logs).
|
||||
|
|
@ -0,0 +1,62 @@
|
|||
---
|
||||
title: 故障排除
|
||||
description: 诊断常见的安装、终端输入、会话、快捷键和远程连接问题。
|
||||
---
|
||||
|
||||
先检查版本和会话状态:
|
||||
|
||||
```bash
|
||||
herdr -V
|
||||
herdr status
|
||||
```
|
||||
|
||||
同时记录操作系统、外层终端名称和版本、会话是本地还是远程，以及是否使用了 tmux。
|
||||
|
||||
## Enter、Tab 或 Backspace 触发两次
|
||||
|
||||
旧版终端在应用启用 Kitty 键盘事件报告后，可能把 Enter、Tab 和 Backspace 的释放事件发送为与按下事件相同的字节。终端发送后，Herdr 无法区分这些重复字节。
|
||||
|
||||
请把外层终端更新到包含上游修复的版本:
|
||||
|
||||
| 终端 | 最低修复版本 |
|
||||
| --- | --- |
|
||||
| kitty | 0.33.0 |
|
||||
| foot | 1.20.0 |
|
||||
| Alacritty | 0.15.0 |
|
||||
|
||||
长期支持版 Linux 发行版中的旧终端软件包尤其容易出现此问题。已确认的边界捕获和上游链接见 [Herdr issue #1116](https://github.com/ogulcancelik/herdr/issues/1116)。如果当前版本仍有问题，请报告准确的终端版本，以及该问题是否也会在 Herdr 外出现。
|
||||
|
||||
## Herdr 已更新，但运行中的会话仍是旧版本
|
||||
|
||||
更新二进制文件不一定会替换已经运行且兼容的服务器。先检查 `herdr status`。要启动更新后的服务器，请停止会话并重新启动 Herdr:
|
||||
|
||||
```bash
|
||||
herdr server stop
|
||||
herdr
|
||||
```
|
||||
|
||||
停止服务器会结束窗格进程。命名会话使用 `herdr session stop <name>`。更新器、软件包管理器和实时移交行为见[安装 Herdr](/zh-cn/docs/install/#update)。
|
||||
|
||||
## 找不到 `herdr` 命令
|
||||
|
||||
重启终端以重新加载环境，然后确认 Herdr 安装目录位于 `PATH` 中。通过软件包管理器安装的 Herdr 必须通过该管理器更新并加入环境。见[安装 Herdr](/zh-cn/docs/install/#verify)。
|
||||
|
||||
## 直接快捷键没有反应
|
||||
|
||||
操作系统或外层终端可能在 Herdr 收到按键前就拦截了组合键。请在对应层释放该组合键，或改用其他绑定。已知冲突和安全默认值见[键盘](/zh-cn/docs/keyboard/#going-prefix-free)。
|
||||
|
||||
## 远程连接无法认证
|
||||
|
||||
先用 `ssh <host>` 确认普通 OpenSSH 连接正常。若在非交互 shell、CI 或移动终端中使用带密码的密钥，请在远程连接前把密钥载入 `ssh-agent`。见[持久化和远程访问](/zh-cn/docs/persistence-remote/#remote-attach-over-ssh)。
|
||||
|
||||
## 查找诊断日志
|
||||
|
||||
Herdr 日志默认位于 `~/.config/herdr/`:
|
||||
|
||||
```text
|
||||
herdr.log
|
||||
herdr-client.log
|
||||
herdr-server.log
|
||||
```
|
||||
|
||||
设置 `HERDR_LOG=herdr=debug` 可获得更多细节。报告问题时请附上当前日志和轮转后的日志。见[配置](/zh-cn/docs/configuration/#logs)。
|
||||
|
|
@ -150,6 +150,7 @@ export default defineConfig({
|
|||
{ label: 'Concepts', translations: { ja: 'コンセプト', 'zh-CN': '核心概念' }, slug: 'docs/concepts' },
|
||||
{ label: 'Keyboard', translations: { ja: 'キーボード', 'zh-CN': '键盘' }, slug: 'docs/keyboard' },
|
||||
{ label: 'How to work with Herdr', translations: { ja: 'Herdr での作業の進め方', 'zh-CN': '使用 Herdr 的工作方式' }, slug: 'docs/how-to-work' },
|
||||
{ label: 'Troubleshooting', translations: { ja: 'トラブルシューティング', 'zh-CN': '故障排除' }, slug: 'docs/troubleshooting' },
|
||||
],
|
||||
},
|
||||
{
|
||||
|
|
|
|||
|
|
@ -0,0 +1,62 @@
|
|||
---
|
||||
title: トラブルシューティング
|
||||
description: インストール、ターミナル入力、セッション、キーバインド、リモート接続の一般的な問題を診断します。
|
||||
---
|
||||
|
||||
まずバージョンとセッション状態を確認します:
|
||||
|
||||
```bash
|
||||
herdr -V
|
||||
herdr status
|
||||
```
|
||||
|
||||
OS、外側のターミナル名とバージョン、ローカルまたはリモートのどちらか、tmux を使用しているかも記録してください。
|
||||
|
||||
## Enter、Tab、Backspace が 2 回入力される
|
||||
|
||||
古いターミナルでは、アプリケーションが Kitty キーボードイベント報告を有効にすると、Enter、Tab、Backspace のリリースをプレスと同じバイトとして送ることがあります。送信後は Herdr から重複したバイトを区別できません。
|
||||
|
||||
上流の修正を含むバージョンへ外側のターミナルを更新してください:
|
||||
|
||||
| ターミナル | 修正済みの最小バージョン |
|
||||
| --- | --- |
|
||||
| kitty | 0.33.0 |
|
||||
| foot | 1.20.0 |
|
||||
| Alacritty | 0.15.0 |
|
||||
|
||||
長期サポート版 Linux ディストリビューションの古いターミナルパッケージで特に発生します。確認済みの境界キャプチャと上流参照は [Herdr issue #1116](https://github.com/ogulcancelik/herdr/issues/1116) を参照してください。現在のターミナルでも発生する場合は、正確なバージョンと Herdr の外でも発生するかを報告してください。
|
||||
|
||||
## Herdr を更新したのに実行中のセッションが古い
|
||||
|
||||
バイナリを更新しても、互換性のある実行中サーバーは自動で置き換わらないことがあります。`herdr status` を確認してください。更新済みサーバーを起動するには、セッションを停止して Herdr を再起動します:
|
||||
|
||||
```bash
|
||||
herdr server stop
|
||||
herdr
|
||||
```
|
||||
|
||||
サーバーを停止するとペインのプロセスも終了します。名前付きセッションでは `herdr session stop <name>` を使います。更新機能、パッケージマネージャー、ライブハンドオフについては[インストール](/ja/docs/install/#update)を参照してください。
|
||||
|
||||
## `herdr` コマンドが見つからない
|
||||
|
||||
ターミナルを再起動して環境を読み込み直し、Herdr のインストール先が `PATH` に含まれていることを確認してください。パッケージマネージャー経由のインストールは、そのパッケージマネージャーから更新して公開する必要があります。[インストール](/ja/docs/install/#verify)を参照してください。
|
||||
|
||||
## 直接キーバインドが動作しない
|
||||
|
||||
OS または外側のターミナルが Herdr に届く前にキーを処理している可能性があります。そのレイヤーでキーを解放するか、別のバインドを選んでください。既知の競合と安全なデフォルトは[キーボード](/ja/docs/keyboard/#going-prefix-free)を参照してください。
|
||||
|
||||
## リモートアタッチで認証できない
|
||||
|
||||
まず `ssh <host>` で通常の OpenSSH 接続が動作することを確認してください。非対話シェル、CI、モバイルターミナルでパスフレーズ付きキーを使う場合は、リモートアタッチの前にキーを `ssh-agent` へ読み込んでください。[永続化とリモートアクセス](/ja/docs/persistence-remote/#remote-attach-over-ssh)を参照してください。
|
||||
|
||||
## 診断ログを探す
|
||||
|
||||
Herdr のログはデフォルトで `~/.config/herdr/` にあります:
|
||||
|
||||
```text
|
||||
herdr.log
|
||||
herdr-client.log
|
||||
herdr-server.log
|
||||
```
|
||||
|
||||
詳細なログには `HERDR_LOG=herdr=debug` を設定します。問題を報告するときは現在のログとローテーション済みログを含めてください。[設定](/ja/docs/configuration/#logs)を参照してください。
|
||||
|
|
@ -0,0 +1,62 @@
|
|||
---
|
||||
title: Troubleshooting
|
||||
description: Diagnose common installation, terminal input, session, keybinding, and remote access problems.
|
||||
---
|
||||
|
||||
Start with the versions and session status:
|
||||
|
||||
```bash
|
||||
herdr -V
|
||||
herdr status
|
||||
```
|
||||
|
||||
Also record your operating system, outer terminal name and version, whether the session is local or remote, and whether tmux is involved.
|
||||
|
||||
## Enter, Tab, or Backspace fires twice
|
||||
|
||||
Older terminal versions can emit the release of Enter, Tab, and Backspace as the same bytes as the press when an application enables Kitty keyboard event reporting. Herdr cannot distinguish those duplicate bytes after the terminal sends them.
|
||||
|
||||
Update the outer terminal to a version containing its upstream fix:
|
||||
|
||||
| Terminal | Minimum fixed version |
|
||||
| --- | --- |
|
||||
| kitty | 0.33.0 |
|
||||
| foot | 1.20.0 |
|
||||
| Alacritty | 0.15.0 |
|
||||
|
||||
This is especially common with older terminal packages from long-term-support Linux distributions. See [Herdr issue #1116](https://github.com/ogulcancelik/herdr/issues/1116) for the confirmed boundary captures and upstream references. If the problem remains on a current terminal version, report the exact terminal version and whether it also happens outside Herdr.
|
||||
|
||||
## Herdr updated, but the running session is still old
|
||||
|
||||
Updating the binary does not always replace a compatible server that is already running. Check `herdr status`. To start the updated server, stop the session and launch Herdr again:
|
||||
|
||||
```bash
|
||||
herdr server stop
|
||||
herdr
|
||||
```
|
||||
|
||||
Stopping a server exits its pane processes. Named sessions use `herdr session stop <name>`. See [Install Herdr](/docs/install/#update) for updater, package-manager, and live-handoff behavior.
|
||||
|
||||
## The `herdr` command is not found
|
||||
|
||||
Restart the terminal so it reloads its environment, then confirm the Herdr install directory is on `PATH`. Package-manager installs must be updated and exposed through that package manager. See [Install Herdr](/docs/install/#verify).
|
||||
|
||||
## A direct keybinding does nothing
|
||||
|
||||
The operating system or outer terminal may consume the chord before Herdr receives it. Free the chord in that layer or choose another binding. See [Keyboard](/docs/keyboard/#going-prefix-free) for known conflicts and safe defaults.
|
||||
|
||||
## Remote attach cannot authenticate
|
||||
|
||||
First confirm that normal OpenSSH works with `ssh <host>`. For a passphrase-protected key in a non-interactive shell, CI job, or mobile terminal, load the key into `ssh-agent` before starting remote attach. See [Persistence and remote access](/docs/persistence-remote/#remote-attach-over-ssh).
|
||||
|
||||
## Find diagnostic logs
|
||||
|
||||
Herdr logs live in `~/.config/herdr/` by default:
|
||||
|
||||
```text
|
||||
herdr.log
|
||||
herdr-client.log
|
||||
herdr-server.log
|
||||
```
|
||||
|
||||
Set `HERDR_LOG=herdr=debug` for more detail. Include the current log and rotated siblings when reporting a problem. See [Configuration](/docs/configuration/#logs).
|
||||
|
|
@ -0,0 +1,62 @@
|
|||
---
|
||||
title: 故障排除
|
||||
description: 诊断常见的安装、终端输入、会话、快捷键和远程连接问题。
|
||||
---
|
||||
|
||||
先检查版本和会话状态:
|
||||
|
||||
```bash
|
||||
herdr -V
|
||||
herdr status
|
||||
```
|
||||
|
||||
同时记录操作系统、外层终端名称和版本、会话是本地还是远程，以及是否使用了 tmux。
|
||||
|
||||
## Enter、Tab 或 Backspace 触发两次
|
||||
|
||||
旧版终端在应用启用 Kitty 键盘事件报告后，可能把 Enter、Tab 和 Backspace 的释放事件发送为与按下事件相同的字节。终端发送后，Herdr 无法区分这些重复字节。
|
||||
|
||||
请把外层终端更新到包含上游修复的版本:
|
||||
|
||||
| 终端 | 最低修复版本 |
|
||||
| --- | --- |
|
||||
| kitty | 0.33.0 |
|
||||
| foot | 1.20.0 |
|
||||
| Alacritty | 0.15.0 |
|
||||
|
||||
长期支持版 Linux 发行版中的旧终端软件包尤其容易出现此问题。已确认的边界捕获和上游链接见 [Herdr issue #1116](https://github.com/ogulcancelik/herdr/issues/1116)。如果当前版本仍有问题，请报告准确的终端版本，以及该问题是否也会在 Herdr 外出现。
|
||||
|
||||
## Herdr 已更新，但运行中的会话仍是旧版本
|
||||
|
||||
更新二进制文件不一定会替换已经运行且兼容的服务器。先检查 `herdr status`。要启动更新后的服务器，请停止会话并重新启动 Herdr:
|
||||
|
||||
```bash
|
||||
herdr server stop
|
||||
herdr
|
||||
```
|
||||
|
||||
停止服务器会结束窗格进程。命名会话使用 `herdr session stop <name>`。更新器、软件包管理器和实时移交行为见[安装 Herdr](/zh-cn/docs/install/#update)。
|
||||
|
||||
## 找不到 `herdr` 命令
|
||||
|
||||
重启终端以重新加载环境，然后确认 Herdr 安装目录位于 `PATH` 中。通过软件包管理器安装的 Herdr 必须通过该管理器更新并加入环境。见[安装 Herdr](/zh-cn/docs/install/#verify)。
|
||||
|
||||
## 直接快捷键没有反应
|
||||
|
||||
操作系统或外层终端可能在 Herdr 收到按键前就拦截了组合键。请在对应层释放该组合键，或改用其他绑定。已知冲突和安全默认值见[键盘](/zh-cn/docs/keyboard/#going-prefix-free)。
|
||||
|
||||
## 远程连接无法认证
|
||||
|
||||
先用 `ssh <host>` 确认普通 OpenSSH 连接正常。若在非交互 shell、CI 或移动终端中使用带密码的密钥，请在远程连接前把密钥载入 `ssh-agent`。见[持久化和远程访问](/zh-cn/docs/persistence-remote/#remote-attach-over-ssh)。
|
||||
|
||||
## 查找诊断日志
|
||||
|
||||
Herdr 日志默认位于 `~/.config/herdr/`:
|
||||
|
||||
```text
|
||||
herdr.log
|
||||
herdr-client.log
|
||||
herdr-server.log
|
||||
```
|
||||
|
||||
设置 `HERDR_LOG=herdr=debug` 可获得更多细节。报告问题时请附上当前日志和轮转后的日志。见[配置](/zh-cn/docs/configuration/#logs)。
|
||||
Loading…
Reference in New Issue