# 使用 Homebrew, Nix 安装 kamal-proxy

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

## 安装

```sh
sudo av install brew:kamal-proxy
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install kamal-proxy
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#kamal-proxy
```

  证据: nixpkgs package indexes: pkgs/by-name/ka/kamal-proxy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:kamal-proxy
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/kamal-proxy>
- **版本:** 0.9.2
- **来源摘要:** Lightweight proxy server for Kamal
- **主页:** <https://kamal-deploy.org/>
- **仓库:** <https://github.com/basecamp/kamal-proxy>
- **上游文档:** <https://github.com/basecamp/kamal-proxy#readme>
- **许可证:** MIT
- **源码归档:** <https://github.com/basecamp/kamal-proxy/archive/refs/tags/v0.9.2.tar.gz>
- **已生成:** 2026-07-08T18:08:21+00:00

## 可执行文件

- kamal-proxy (cli)
- kamal-proxy (别名)

## 构建依赖

- go

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-07-08
- 管理器版本: 0.9.2
- 本地数据: OK
- 上游仓库: https://github.com/basecamp/kamal-proxy
- 检测到的最新版本: v0.9.2 (当前)
- 信息: No package-manager update timestamp was available.
## 项目历史与用法

Kamal Proxy is a small HTTP proxy from Basecamp for coordinating zero-downtime deployments behind Kamal. It exists to handle health checks, traffic switching, draining, host-based routing, path-based routing, and TLS features without requiring application code to participate in the deployment handoff.

### 项目历史

The repository was created on 2024-03-21. Its README describes the proxy as part of Kamal's deployment experience, but also as usable standalone or in other deployment tooling.

Kamal itself is Basecamp's container deployment tool, originally built for Rails apps but documented as usable for any Docker-containerized web app. Kamal Proxy became the dedicated routing piece in that ecosystem, replacing ad hoc proxy handoff logic with a small Go service and CLI.

### 采用历史

Adoption follows Kamal adoption: teams using Kamal for single-server or small-fleet Docker deployments need a predictable way to switch traffic after a new container passes health checks. Homebrew and Nix packaging make the proxy available outside Kamal's own install path for operators who manage tools through system package managers.

### 使用方式

The README documents `kamal-proxy run` for starting the proxy and `kamal-proxy deploy` for registering a target service. Deployments wait for a new target to become healthy, route new traffic there, and drain traffic from the old target before returning.

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

Kamal Proxy is package-interesting because it is a subcomponent split out of a deployment system but useful enough to package as its own executable. It also reflects the 2020s return of simpler self-hosting tools: SSH, Docker, one proxy, and explicit release handoff instead of a full orchestrator.

### 时间线

- 2024: basecamp/kamal-proxy repository created.
- 2024: v0.1.0 and later tags appeared in the repository.
- 2026: Kamal release notes required kamal-proxy v0.9.2 for Kamal v2.11.0 deployments.

### Related projects

- Kamal is the parent deployment tool that uses Kamal Proxy for request switching.
- It sits in the same operational space as reverse proxies and load balancers used for blue-green or rolling web deployments, but with a narrower Kamal-oriented interface.

### 来源

- <https://api.github.com/repos/basecamp/kamal-proxy>
- <https://github.com/basecamp/kamal>
- <https://github.com/basecamp/kamal-proxy>
- <https://github.com/basecamp/kamal-proxy/tags>
- <https://github.com/basecamp/kamal/releases>
- <https://kamal-deploy.org/>


## 安全说明

broad file, network, media, or database tool signal.

- **Geiger 风险:** blue / 中
- broad file, network, media, or database tool signal

## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** kamal-proxy
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

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

- Nix - kamal-proxy: normalized package name match | nixpkgs package indexes: pkgs/by-name/ka/kamal-proxy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## 相关链接

- [Secret-risk packages](https://www.automicvault.com/zh-hans/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/zh-hans/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/zh-hans/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [go](https://www.automicvault.com/zh-hans/pkg/brew/go/) - Build dependency declared by Homebrew.
- [deployer](https://www.automicvault.com/zh-hans/pkg/brew/deployer/) - Shares av.db curated category or tags: cli, deployment, developer-tools.
- [doubledown](https://www.automicvault.com/zh-hans/pkg/brew/doubledown/) - Shares av.db curated category or tags: cli, deployment, developer-tools.
- [fabric](https://www.automicvault.com/zh-hans/pkg/brew/fabric/) - Shares av.db curated category or tags: cli, deployment, developer-tools.
- [git-ftp](https://www.automicvault.com/zh-hans/pkg/brew/git-ftp/) - Shares av.db curated category or tags: cli, deployment, developer-tools.
- [kapp](https://www.automicvault.com/zh-hans/pkg/brew/kapp/) - Shares av.db curated category or tags: cli, deployment, developer-tools.
- [kargo](https://www.automicvault.com/zh-hans/pkg/brew/kargo/) - Shares av.db curated category or tags: cli, deployment, developer-tools.
- [modman](https://www.automicvault.com/zh-hans/pkg/brew/modman/) - Shares av.db curated category or tags: cli, deployment, developer-tools.
- [netlify-cli](https://www.automicvault.com/zh-hans/pkg/brew/netlify-cli/) - Shares av.db curated category or tags: cli, deployment, developer-tools.
- [mockserver](https://www.automicvault.com/zh-hans/pkg/brew/mockserver/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, developer, developer-tools, http, proxy.

## Combined YAML source

View the package source record on GitHub. [combined/kamal-proxy.yml](https://github.com/automic-vault/db/blob/main/combined/kamal-proxy.yml)


## 来源

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph