# process-exporter

**Repository Path**: totongf/process-exporter

## Basic Information

- **Project Name**: process-exporter
- **Description**: process-exporter 国内安装镜像（一键脚本，gh-proxy 双源下载）
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-10
- **Last Updated**: 2026-06-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# process-exporter 国内安装镜像

`ncabatoff/process-exporter` 的国内安装镜像仓库。

> 上游：<https://github.com/ncabatoff/process-exporter>  
> 国内镜像：<https://gitee.com/totongf/process-exporter>  
> 默认分支：`main`（amd64 二进制存于 `bin/`）

## 一句话安装

```bash
curl -fsSL https://gitee.com/totongf/process-exporter/raw/main/install.sh | sudo bash
```

脚本会按下面的顺序自动选源：

1. **Gitee 仓内** `bin/process-exporter-${VERSION}.linux-amd64.tar.gz`（仅 amd64，国内直连，sha256 强校验）
2. **gh-proxy.com** GitHub 镜像（非 amd64 架构兜底，国内 CDN）
3. **GitHub 官方 release**（最终兜底）

amd64 机器上**主源就是 Gitee 仓本身**，不依赖任何外部镜像。

安装完成后：
- 二进制：`/usr/local/bin/process-exporter`
- 配置：`/etc/process-exporter/config.yml`
- 端口：`:9256`
- 服务：`systemctl status process-exporter`

## 自检

```bash
curl -s http://127.0.0.1:9256/metrics | grep namedprocess
```

## 升级

```bash
VERSION=0.8.7  # 改成目标版本
curl -fsSL https://gitee.com/totongf/process-exporter/raw/main/install.sh \
  | sudo VERSION=${VERSION} bash
```

升级时需要维护者同步：
1. 把新版本的 tarball 放到 `bin/` 目录
2. 重生成 `bin/process-exporter-X.Y.Z.linux-amd64.tar.gz.sha256`
3. install.sh 默认 `VERSION=0.8.7` 改新值
4. commit + push

## Prometheus 接入

```yaml
scrape_configs:
  - job_name: process-exporter
    scrape_interval: 15s
    static_configs:
      - targets: ['<host>:9256']
```

## 仓库结构

```
.
├── README.md
├── install.sh                      一键安装脚本（主源 Gitee 仓 + sha256 强校验 + 4 级兜底）
├── config.example.yml              配置示例（0.8.x 格式：白名单 cmdline 防敏感参数泄露）
├── service.example                 systemd unit 示例
├── .gitignore
└── bin/
    ├── process-exporter-0.8.7.linux-amd64.tar.gz        4.4MB 安装包
    └── process-exporter-0.8.7.linux-amd64.tar.gz.sha256  sha256 校验文件
```

## 隐私保护

默认采集**所有有 comm 名的进程**，但 label 只显示 `comm`（进程二进制名）—— **不会泄露 cmdline 参数**（密码/token/连接串都不在 label 里）。

如果想 label 显示完整命令行（**含敏感参数，谨慎开启**），改用 `name: "{{.Cmdline}}"`：

```yaml
process_names:
  - name: "{{.Cmdline}}"
    cmdline:
      - ".+"
```

如果只想采特定服务进程（白名单），用 `name: "{{.Comm}}"` + cmdline 限定：

```yaml
process_names:
  - name: "{{.Comm}}"
    cmdline:
      - "nginx"
      - "java"
      - "redis-server"
```

## 镜像同步机制

- **amd64**：本仓 `bin/` 目录直接存放 tarball，install.sh 主源拉仓内文件，sha256 强校验
- **非 amd64（arm64/386/armv7）**：install.sh 走 gh-proxy.com → GitHub 官方 release 兜底（仓不打包）
- 主源不可达时自动切到兜底源

## 维护

- 上游版本变更：放新 tarball 到 `bin/`，重生成 `.sha256`，改 install.sh 默认 `VERSION`
- 多架构支持：把 arm64/386/armv7 tarball 也放到 `bin/`，同时修 install.sh `PRIMARY_SOURCES` 让它们走仓内源