# 使用 Homebrew 安装 edgevpn

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

## 安装

```sh
sudo av install brew:edgevpn
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install edgevpn
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:edgevpn
- **软件包管理器:** Homebrew
- **版本:** 0.35.3
- **来源摘要:** Immutable, decentralized, statically built p2p VPN
- **主页:** <https://mudler.github.io/edgevpn>
- **仓库:** <https://github.com/mudler/edgevpn>
- **最后更新:** 2026-07-26T04:11:36+02:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- edgevpn (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

EdgeVPN is a Go/libp2p tool for creating decentralized private networks, reverse proxies, and peer-to-peer file transfers using shared tokens or configuration files instead of a central VPN server.

### 项目历史

The GitHub repository was created in May 2021. The README frames the project as an experiment with libp2p and as a more open, less-infrastructure alternative to ngrok-style tunneling.

By 2026, the project had an active release stream, with GitHub releases including v0.35.2 in June 2026. The README describes a broader scope than VPN alone: reverse proxying, p2p file transfer, a library interface, and an internal distributed ledger.

### 采用历史

Official adoption evidence is strongest inside related cloud-native projects. The README says the Kairos CNCF project uses EdgeVPN as a layer for creating decentralized Kubernetes clusters, and that EdgeVPN powers LocalAI's P2P features.

Homebrew packaging gives workstation users a simple install path, while the upstream README primarily directs users to precompiled static releases and source usage.

### 使用方式

Users generate a config file with `edgevpn -g > config.yaml` or an encoded token with `edgevpn -g -b`, then share that network definition among peers. The README warns that exposing the file or token is equivalent to giving full control of the network.

Common uses include starting a VPN interface with per-node virtual addresses, exposing TCP services through the p2p network, sending files, and embedding EdgeVPN as a Go library.

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

EdgeVPN is interesting to package people because it bundles modern p2p networking into a single static CLI with very little central infrastructure. It lives in the same mental drawer as VPNs, tunnels, reverse proxies, and Kubernetes lab tooling.

The project also shows the current package-manager appetite for edge and homelab networking tools: install one binary, generate a token, and assemble an overlay network without running a coordinator service.

### 时间线

- 2021-05: GitHub repository created.
- 2021: README screenshots and early documentation show dashboard and networking features.
- 2026-05: Release stream reaches v0.34.0.
- 2026-06: Release v0.35.2 published.

### Related projects

- libp2p is the underlying p2p networking stack credited by the project.
- Kairos uses EdgeVPN for decentralized Kubernetes cluster networking.
- LocalAI uses EdgeVPN for P2P features.
- k3s appears in the README as an example Kubernetes cluster use case.

### 来源

- <https://raw.githubusercontent.com/mudler/edgevpn/master/README.md>
- <https://api.github.com/repos/mudler/edgevpn>
- <https://api.github.com/repos/mudler/edgevpn/releases>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: config.yaml

## Credential files

- Unix: config.yaml

## Combined YAML source

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


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph
