# 使用 Homebrew, Nix 安装 git-pages

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

## 安装

```sh
sudo av install brew:git-pages
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install git-pages
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#git-pages
```

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

## 软件包事实

- **软件包键:** brew:git-pages
- **软件包管理器:** Homebrew
- **版本:** 0.9.1
- **来源摘要:** Scalable static site server for Git forges
- **主页:** <https://codeberg.org/git-pages/git-pages>
- **最后更新:** 2026-07-25T20:55:22-04:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- git-pages (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

git-pages is a Go static-site server for Git forges, positioned by its maintainers as a GitHub Pages replacement that can run on ordinary infrastructure, scale horizontally, and store site data on a filesystem or S3-compatible object store.

### 项目历史

The public Codeberg repository was created in September 2025 under the git-pages organization, whose profile describes the project family as static-site server and publishing tools. The repository describes a server-centered design with optional Caddy integration for TLS, first-party container images, and companion publishing tools for users who want to publish to a hosted Pages service.

Release tags show a rapid early sequence from v0.1.0 in November 2025 through v0.9.x in 2026. The README records a migration from an original filesystem architecture to a v2 architecture based around manifests and object storage, reflecting an evolution from a simple local tree layout toward backends better suited to S3-style storage.

### 采用历史

The project is young compared with older Git workflow utilities, but it gained package-manager coverage through Homebrew and Nix and documents packaged binaries, containers, and source installation. Codeberg metadata shows hundreds of stars, which is notable for a specialized static-site hosting server tied to Forgejo/Gitea-style workflows.

### 使用方式

Practitioners use git-pages by running the server, publishing a repository or archive to it through HTTP methods, and serving the branch or uploaded archive as a static site. The README emphasizes the pages branch, Forgejo/Gitea/Gogs/GitHub webhook payloads, DNS-based authorization, optional Caddy TLS, and filesystem or S3-compatible storage.

Operators care about it as infrastructure rather than a desktop helper: configuration, credentials, authorization policy, object-store behavior, metrics, syslog, and atomic updates are part of the normal operating surface.

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

For package-index users, git-pages is interesting because it turns the familiar Pages pattern into a self-hostable service with a small Go binary, container images, and Nix/Homebrew packaging. Its README also points to related first-party packages such as git-pages-cli and a Forgejo Action, making it part of a small publishing ecosystem rather than a single executable.

### 时间线

- 2025: Codeberg repository created under the git-pages organization.
- 2025: v0.1.0 tag published.
- 2025: v0.3.x release notes introduced TOML config output and site diagnostics.
- 2026: v0.8.x and v0.9.x release notes focused on authorization and Caddy-related security fixes.

### Related projects

- git-pages-cli is the companion client for publishing to a git-pages service.
- git-pages/action is a Forgejo Action for publishing from forge workflows.
- Caddy is documented as the recommended TLS front end for the server.

### 来源

- <https://codeberg.org/api/v1/repos/git-pages/git-pages>
- <https://codeberg.org/git-pages/git-pages>
- <https://codeberg.org/git-pages/git-pages/releases>
- <https://git-pages.org/>


## 安全说明

没有找到 git-pages 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。



## 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.toml, /etc/git-pages/config.toml

## Credential files

- Unix: $CREDENTIALS_DIRECTORY/secrets.toml, /etc/git-pages/secrets.toml
## 其他软件包管理器记录

- Nix - git-pages: normalized package name match | nixpkgs package indexes: pkgs/by-name/gi/git-pages/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/git-pages.yml](https://github.com/mxcl/pkgdb/blob/main/combined/git-pages.yml)


## 来源

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