> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/man1/ssh-copy-id.1.md).

# ssh-copy-id.1

`ssh-copy-id` — 将公钥复制到远程主机

## 名称

`ssh-copy-id`

## 概要

`ssh-copy-id [-lv] [-i keyfile] [-o option] [-p port] [user@]hostname`

## 描述

`ssh-copy-id` 工具将公钥复制到远程主机的 **\~/.ssh/authorized\_keys** 文件中（如有需要，会创建该文件和目录）。

可用选项如下：

**`-i`** `file` 复制 `file` 中包含的公钥。此选项可多次指定，并可与 `-l` 选项组合使用。如果指定了私钥且找到了对应的公钥，则使用公钥。

**`-l`** 复制 ssh-agent(1) 当前持有的密钥。如果未指定 `-i` 选项，则此为默认行为。

**`-o`** `ssh-option` 将此选项直接传递给 [ssh(1)](/man/man1/ssh.1.md)。此选项可多次指定。

**`-p`** `port` 连接到远程主机上的指定端口，而非默认端口。

**`-v`** 将 `-v` 传递给 [ssh(1)](/man/man1/ssh.1.md)。

其余参数为要连接的远程主机列表，每个主机可附带用户名。

## 退出状态

`ssh-copy-id` 工具成功时退出值为 0，发生错误时大于 0。

## 实例

将特定密钥发送到多台主机：

```sh
$ ssh-copy-id -i /path/to/keyfile.pub user@host1 user@host2 user@host3
```

## 历史

`ssh-copy-id` 工具由 Eitan Adler <eadler@FreeBSD.org> 编写，作为 OpenSSH 中已有同名工具的直接替代品。


---

# 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://book.bsdcn.org/man/man1/ssh-copy-id.1.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.