> For the complete documentation index, see [llms.txt](https://help.ppgg.in/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.ppgg.in/docs/self-hosting/connect-clients/connect-individual-clients.md).

# 连接个人客户端

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/change-client-environment/)
{% endhint %}

默认情况下，Bitwarden 客户端连接到 Bitwarden 托管的服务器，但也可以将客户端应用程序配置为连接到您的自托管 Bitwarden 实例。

{% hint style="info" %}
如果您希望连接到 Bitwarden 托管的服务器，但您的客户端却试图连接到自托管的实例，请从**登录到**菜单中选择 **bitwarden.com** 或 **bitwarden.eu**。
{% endhint %}

{% tabs %}
{% tab title="浏览器扩展" %}
要将浏览器扩展连接到您的自托管服务器：

1、在登录或注册界面，选择**登录到**下拉菜单，然后选择**自托管**选项。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1Pq95ZZLLySxwjLr7eul5W/326732e7943499236adf16e6a16378b6/2024-12-04_10-05-14.png?w=1064&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展自托管服务器选择</p></figcaption></figure></div>

2、在**服务器 URL** 字段中，输入以 `https://` 开头的您的服务器的域名（例如，`https://my.bitwarden.domain.com`）。

3、选择**保存**。

{% hint style="success" %}
具有特殊设置的用户，可以选择在**自定义环境**部分中单独指定每个服务的 URL。
{% endhint %}
{% endtab %}

{% tab title="移动 App" %}
要将移动 App 连接到您的自托管服务器：

1、在登录或注册界面，选择**登录到**下拉菜单，然后选择**自托管**选项。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/0mBtygWpIfx8MLtcPwxwD/0041c5a129a88b9fb5dd021a07a6da4e/2025-01-22_10-17-39.png?w=715&#x26;fm=avif" alt=""><figcaption><p>移动端自托管服务器选择</p></figcaption></figure></div>

2、在**服务器 URL** 字段中，输入以 `https://` 开头的您的服务器的域名（例如，`https://my.bitwarden.domain.com`）。

3、如果您的自托管服务器要求证书，请上传证书。

4、选择**保存**。

{% hint style="success" %}
具有特殊设置的用户，可以选择在**自定义环境**部分中单独指定每个服务的 URL。
{% endhint %}
{% endtab %}

{% tab title="桌面 App" %}
登录到您的桌面 App 的[每一个账户](/docs/account/log-in-and-unlock/more-log-in-options/account-switching.md)都可以连接到不同的服务器。要将账户连接到您的自托管服务器：

1、在登录或注册界面，选择**登录到**下拉菜单，然后选择**自托管**选项。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3FlU02971dqGGkp86WJJc5/e5c40a136a11ee48c5e74a068bda2405/2026-04-23_09-17-05.png?w=800&#x26;fm=avif" alt=""><figcaption><p>桌面端自托管服务器选择</p></figcaption></figure></div>

2、在**服务器 URL** 字段中，输入以 `https://` 开头的您的服务器的域名（例如，`https://my.bitwarden.domain.com`）。

3、选择**保存**。

{% hint style="success" %}
具有特殊设置的用户，可以选择在**自定义环境**部分中单独指定每个服务的 URL。
{% endhint %}
{% endtab %}

{% tab title="CLI" %}
要将 CLI 连接到您的自托管服务器：

1. 使用 `bw logout` 命令注销。
2. 使用如下命令将 CLI 连接到您的自托管服务器：

```bash
bw config server https://your.bw.domain.com
```

具有特殊设置的用户，可以使用以下命令单独指定每个服务的 URL：

```bash
bw config server --web-vault <url>
bw config server --api <url>
bw config server --identity <url>
bw config server --icons <url>
bw config server --notifications <url>
bw config server --events <url>
bw config server --key-connector <url>
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.ppgg.in/docs/self-hosting/connect-clients/connect-individual-clients.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
