# 使用 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
- **版本:** 0.9.2
- **来源摘要:** Lightweight proxy server for Kamal
- **主页:** <https://kamal-deploy.org/>
- **仓库:** <https://github.com/basecamp/kamal-proxy>
- **最后更新:** 2026-07-27T21:58:36+02:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- kamal-proxy (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

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

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

- 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


## Combined YAML source

View the package source record on GitHub. [combined/kamal-proxy.yml](https://github.com/mxcl/pkgdb/blob/main/combined/kamal-proxy.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