# kamal-proxy を Homebrew, Nix でインストール

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
