# 在 Linux 上安装 Collector

LLMS index: [llms.txt](/llms.txt)

---

每个 Collector 版本都包含适用于 Linux amd64/arm64/i386 系统的 APK、DEB 和 RPM 包。安装后，你可以在 `/etc/otelcol/config.yaml` 找到默认配置。

> 注意：自动服务配置需要 `systemd`。

## DEB 安装 {#deb-installation}

在 Debian 系统上入门，请运行以下命令：

    <ul class="nav nav-tabs" id="tabs-0" role="tablist">
  <li class="nav-item">
      <button class="nav-link active"
          id="tabs-00-00-tab" data-bs-toggle="tab" data-bs-target="#tabs-00-00" role="tab"
          data-td-tp-persist="amd64" aria-controls="tabs-00-00" aria-selected="true">
        AMD64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-00-01-tab" data-bs-toggle="tab" data-bs-target="#tabs-00-01" role="tab"
          data-td-tp-persist="arm64" aria-controls="tabs-00-01" aria-selected="false">
        ARM64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-00-02-tab" data-bs-toggle="tab" data-bs-target="#tabs-00-02" role="tab"
          data-td-tp-persist="i386" aria-controls="tabs-00-02" aria-selected="false">
        i386
      </button>
    </li>
</ul>

<div class="tab-content" id="tabs-0-content">
    <div class="tab-body tab-pane fade show active"
        id="tabs-00-00" role="tabpanel" aria-labelled-by="tabs-00-00-tab" tabindex="0">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo apt-get update
</span></span><span class="line"><span class="cl">sudo apt-get -y install wget
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_amd64.deb
</span></span><span class="line"><span class="cl">sudo dpkg -i otelcol_0.149.0_linux_amd64.deb
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-00-01" role="tabpanel" aria-labelled-by="tabs-00-01-tab" tabindex="0">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo apt-get update
</span></span><span class="line"><span class="cl">sudo apt-get -y install wget
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_arm64.deb
</span></span><span class="line"><span class="cl">sudo dpkg -i otelcol_0.149.0_linux_arm64.deb
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-00-02" role="tabpanel" aria-labelled-by="tabs-00-02-tab" tabindex="0">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo apt-get update
</span></span><span class="line"><span class="cl">sudo apt-get -y install wget
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_386.deb
</span></span><span class="line"><span class="cl">sudo dpkg -i otelcol_0.149.0_linux_386.deb
</span></span></code></pre></div>
    </div>
</div>


## RPM 安装 {#rpm-installation}

在 Red Hat 系统上入门，请运行以下命令：

    <ul class="nav nav-tabs" id="tabs-1" role="tablist">
  <li class="nav-item">
      <button class="nav-link active"
          id="tabs-01-00-tab" data-bs-toggle="tab" data-bs-target="#tabs-01-00" role="tab"
          data-td-tp-persist="amd64" aria-controls="tabs-01-00" aria-selected="true">
        AMD64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-01-01-tab" data-bs-toggle="tab" data-bs-target="#tabs-01-01" role="tab"
          data-td-tp-persist="arm64" aria-controls="tabs-01-01" aria-selected="false">
        ARM64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-01-02-tab" data-bs-toggle="tab" data-bs-target="#tabs-01-02" role="tab"
          data-td-tp-persist="i386" aria-controls="tabs-01-02" aria-selected="false">
        i386
      </button>
    </li>
</ul>

<div class="tab-content" id="tabs-1-content">
    <div class="tab-body tab-pane fade show active"
        id="tabs-01-00" role="tabpanel" aria-labelled-by="tabs-01-00-tab" tabindex="1">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo yum update
</span></span><span class="line"><span class="cl">sudo yum -y install wget systemctl
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_amd64.rpm
</span></span><span class="line"><span class="cl">sudo rpm -ivh otelcol_0.149.0_linux_amd64.rpm
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-01-01" role="tabpanel" aria-labelled-by="tabs-01-01-tab" tabindex="1">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo yum update
</span></span><span class="line"><span class="cl">sudo yum -y install wget systemctl
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_arm64.rpm
</span></span><span class="line"><span class="cl">sudo rpm -ivh otelcol_0.149.0_linux_arm64.rpm
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-01-02" role="tabpanel" aria-labelled-by="tabs-01-02-tab" tabindex="1">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo yum update
</span></span><span class="line"><span class="cl">sudo yum -y install wget systemctl
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_386.rpm
</span></span><span class="line"><span class="cl">sudo rpm -ivh otelcol_0.149.0_linux_386.rpm
</span></span></code></pre></div>
    </div>
</div>


## 手动安装 {#manual-installation}

Linux [发布版本](https://github.com/open-telemetry/opentelemetry-collector-releases/releases)提供多种架构的二进制文件。你可以下载并在本机手动安装：

     <ul class="nav nav-tabs" id="tabs-2" role="tablist">
  <li class="nav-item">
      <button class="nav-link active"
          id="tabs-02-00-tab" data-bs-toggle="tab" data-bs-target="#tabs-02-00" role="tab"
          data-td-tp-persist="amd64" aria-controls="tabs-02-00" aria-selected="true">
        AMD64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-02-01-tab" data-bs-toggle="tab" data-bs-target="#tabs-02-01" role="tab"
          data-td-tp-persist="arm64" aria-controls="tabs-02-01" aria-selected="false">
        ARM64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-02-02-tab" data-bs-toggle="tab" data-bs-target="#tabs-02-02" role="tab"
          data-td-tp-persist="i386" aria-controls="tabs-02-02" aria-selected="false">
        i386
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-02-03-tab" data-bs-toggle="tab" data-bs-target="#tabs-02-03" role="tab"
          data-td-tp-persist="ppc64le" aria-controls="tabs-02-03" aria-selected="false">
        ppc64le
      </button>
    </li>
</ul>

<div class="tab-content" id="tabs-2-content">
    <div class="tab-body tab-pane fade show active"
        id="tabs-02-00" role="tabpanel" aria-labelled-by="tabs-02-00-tab" tabindex="2">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">curl --proto <span class="s1">&#39;=https&#39;</span> --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_amd64.tar.gz
</span></span><span class="line"><span class="cl">tar -xvf otelcol_0.149.0_linux_amd64.tar.gz
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-02-01" role="tabpanel" aria-labelled-by="tabs-02-01-tab" tabindex="2">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">curl --proto <span class="s1">&#39;=https&#39;</span> --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_arm64.tar.gz
</span></span><span class="line"><span class="cl">tar -xvf otelcol_0.149.0_linux_arm64.tar.gz
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-02-02" role="tabpanel" aria-labelled-by="tabs-02-02-tab" tabindex="2">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">curl --proto <span class="s1">&#39;=https&#39;</span> --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_386.tar.gz
</span></span><span class="line"><span class="cl">tar -xvf otelcol_0.149.0_linux_386.tar.gz
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-02-03" role="tabpanel" aria-labelled-by="tabs-02-03-tab" tabindex="2">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">curl --proto <span class="s1">&#39;=https&#39;</span> --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_ppc64le.tar.gz
</span></span><span class="line"><span class="cl">tar -xvf otelcol_0.149.0_linux_ppc64le.tar.gz
</span></span></code></pre></div>
    </div>
</div>


## 自动服务配置 {#automatic-service-configuration}

当 OpenTelemetry Collector 作为 `systemd` 服务运行时，会默认使用 `/etc/otelcol/config.yaml` 配置文件启动。

如果你想更改此设置，可以编辑 `systemd` 环境文件 `/etc/otelcol/otelcol.conf` 中的 `OTELCOL_OPTIONS` 变量。你还可以在同一文件中为 `otelcol` 服务定义其他环境变量。支持选项的完整列表，请运行以下命令：

```sh
/usr/bin/otelcol --help
```

如果修改了 Collector 配置文件 (`config.yaml`) 或环境文件 (`otelcol.conf`)，必须重启服务以应用更改：

```sh
sudo systemctl restart otelcol
```

要查看 `otelcol` 服务的日志输出，请运行：

```sh
sudo journalctl -u otelcol
```