# 使用 Homebrew, apk, apt, Nix, winget 安装 tkey-ssh-agent

查看 tkey-ssh-agent 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:tkey-ssh-agent
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install tkey-ssh-agent
```

  证据: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add tkey-ssh-agent
```

  证据: Alpine Linux edge package indexes: tkey-ssh-agent from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install tkey-ssh-agent
```

  证据: Debian stable package indexes: tkey-ssh-agent from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#tkey-ssh-agent
```

  证据: nixpkgs package indexes: pkgs/by-name/tk/tkey-ssh-agent/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- winget (92%):

```sh
winget install --id Tillitis.TKeySSHAgent -e
```

  证据: Windows Package Manager source index: Tillitis.TKeySSHAgent from https://cdn.winget.microsoft.com/cache/source.msix

## 软件包事实

- **软件包键:** brew:tkey-ssh-agent
- **软件包管理器:** Homebrew
- **版本:** 1.1.1
- **来源摘要:** SSH agent for use with the TKey security stick
- **主页:** <https://tillitis.se/>
- **仓库:** <https://github.com/tillitis/tkey-ssh-agent>
- **最后更新:** 2026-07-26T00:50:42+02:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- tkey-ssh-agent (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 1.1.1
## 项目历史与用法

tkey-ssh-agent is an OpenSSH-compatible agent for the Tillitis TKey USB security token. It bridges the standard SSH agent protocol with a small open hardware/software signing device.

### 项目历史

The official README describes tkey-ssh-agent as an OpenSSH-compatible agent for use with the Tillitis TKey USB security token. The project embeds a signer device application and warns users to prefer tagged releases because changes to the signer app, user-supplied secret, or user device secret can change the resulting SSH key pair.

The release notes show an early v0.0.1 phase focused on a revised SSH agent for Linux distributions, daemon operation, udev-based TKey detection, and pinentry for the user-supplied secret. Version 1.0.0 separated related apps, libraries, and packages into their own repositories, embedded the binary signer to enable go install, and added release/package builds with GoReleaser.

### 采用历史

The project is aimed at TKey users who want SSH authentication without storing private keys on a general-purpose computer. Its packaging path followed both source installs and OS packages: the README mentions operating-system package systems, go install, manual pages, udev rules, and systemd units.

The supplied package-manager facts show availability through Homebrew, Alpine/apk, Debian source packaging, Nix, and winget, which is unusually broad for a hardware-token-specific SSH utility.

### 使用方式

A typical use starts the agent on a chosen socket, optionally selects the serial port, then points SSH_AUTH_SOCK at that socket before using OpenSSH. The README also documents a public-key display mode and USS flags for user-supplied secrets.

For package nerds, the interesting part is that the installed CLI is only half the artifact: udev rules, systemd service files, manual pages, embedded signer binaries, and reproducible release packages all matter for a usable install.

### 为什么软件包爱好者会关心

tkey-ssh-agent sits at the intersection of open hardware, SSH agent ergonomics, and distro packaging. Its release notes make key continuity a packaging concern because changing firmware, signer binaries, or secret handling can change the generated SSH identity.

It is a useful example of a niche security package where version pinning, tagged releases, and release notes are operationally important rather than cosmetic.

### 时间线

- v0.0.1: Release notes describe the revised SSH agent with daemon operation, udev detection, and pinentry support.
- v1.0.0: Related apps and libraries moved to separate repositories; embedded signer enabled go install; GoReleaser package builds added.
- 2026-03-24: GitHub releases page lists v1.1.1 with updated tkeyclient handling for TKey Unlocked.

### Related projects

- Tillitis TKey is the hardware/software USB security token targeted by the agent.
- OpenSSH is the client ecosystem consuming the SSH agent socket.
- tkey-device-signer, tkeyclient, and tkeysign are related Tillitis components named in the release notes.

### 来源

- <https://github.com/tillitis/tkey-ssh-agent README for purpose, install, usage, USS, and build behavior>
- <https://github.com/tillitis/tkey-ssh-agent/blob/main/docs/release_notes.md for v0.0.1, v1.0.0, and v1.1.0 history>
- <https://github.com/tillitis/tkey-ssh-agent/releases for release chronology and package assets>
- source_facts.package-manager for package availability


## 安全说明

broad file, network, media, or database tool signal. formula declares a Homebrew service.

- **Geiger 风险:** orange / 中
- broad file, network, media, or database tool signal
- formula declares a Homebrew service

## 其他软件包管理器记录

- Debian apt - golang-github-tillitis-tkey-ssh-agent-dev - 1.0.0+ds-4: normalized package name match | Debian stable package indexes: golang-github-tillitis-tkey-ssh-agent-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | SSH Agent for Tillitis TKey (Go development library) | https://github.com/tillitis/tkey-ssh-agent
- Debian apt - tillitis-tkey-udev - 1.0.0+ds-4: normalized package name match | Debian stable package indexes: tillitis-tkey-udev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Tillitis TKey udev rule | https://github.com/tillitis/tkey-ssh-agent
- Debian apt - tkey-ssh-agent - 1.0.0+ds-4+b2: normalized package name match | Debian stable package indexes: tkey-ssh-agent from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | SSH Agent for Tillitis TKey (application) | https://github.com/tillitis/tkey-ssh-agent
- Nix - tkey-ssh-agent: normalized package name match | nixpkgs package indexes: pkgs/by-name/tk/tkey-ssh-agent/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - tkey-ssh-agent - 1.1.1-r3: normalized package name match | Alpine Linux edge package indexes: tkey-ssh-agent from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | SSH Agent for TKey, a flexible open hardware/software USB security key | https://www.tillitis.se/
- apk - tkey-ssh-agent-doc - 1.1.1-r3: normalized package name match | Alpine Linux edge package indexes: tkey-ssh-agent-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | SSH Agent for TKey, a flexible open hardware/software USB security key (documentation) | https://www.tillitis.se/
- apk - tkey-ssh-agent-udev - 1.1.1-r3: normalized package name match | Alpine Linux edge package indexes: tkey-ssh-agent-udev from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | SSH Agent for TKey, a flexible open hardware/software USB security key (udev rules) | https://www.tillitis.se/
- winget - Tillitis.TKeySSHAgent: normalized package name match | Windows Package Manager source index: Tillitis.TKeySSHAgent from https://cdn.winget.microsoft.com/cache/source.msix


## Combined YAML source

View the package source record on GitHub. [combined/tkey-ssh-agent.yml](https://github.com/mxcl/pkgdb/blob/main/combined/tkey-ssh-agent.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph