跳转至

密钥操作与文件同步

创建于：2025-08-20 最后更新：2025-09-17

简介说明

假设你有两台主机，一台为 本地主机，另一台为云端的 远程主机（服务器）。本节会记录以下实践：

  1. 配置 远程主机 开发环境中的用户与组。
  2. 通过生成并配置密钥的方式，实现 本地主机 到 远程主机 的 ssh 免密登录。
  3. 最后利用 rsync 工具同步 远程主机 与 本地主机 的静态网页文件内容。

前置条件

  • 系统要求：Debian 12 (bookworm)
  • 相关工具：openssh-client 9.2p1、openssh-server 9.2p1、rsync 3.2.7

安装与配置

下方直接提供了实现所有操作的 shell 脚本：

  • 脚本 user_and_group.sh 实现了开发人员账户与组、远程项目文件夹及其权限的配置，在 远程主机 执行。
  • 脚本 generate_ssh_key.sh 实现了密钥生成与免密登录的配置1，在 本地主机 执行。
  • 脚本 rsync_to_remote.sh 实现了 本地主机 与 远程主机 项目文件夹的文件同步，在 本地主机 执行。
关于脚本执行权限的一些说明
  • 脚本 user_and_group.sh 必须使用 sudo 以获取 root 权限执行。
  • 脚本 generate_ssh_key.sh 和 rsync_to_remote.sh 则不用 sudo权限，但脚本执行命令 ssh-copy-id 配置时，会要求输入 远程主机 的密码。

远程主机脚本

使用下方脚本时，需要输入一个参数以提供用户名，例如 ./user_and_group.sh akiyama。

user_and_group.sh
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
#!/usr/bin/env sh
# Script Name: user_and_group.sh
# Author: Aina
# Date Created: 2025-08-20 | Date Modified: 2025-08-23

# Exit immediately if a command exits with a non-zero status
# Treat unset variables as an error and exit immediately
set -eu

# Check the permission
if [ $(id -u) -ne 0 ]; then
    echo 'This script must be run with `sudo`.'
    exit 1
fi

# Difine variables
username=${1:?Plesae enter the username.}
passwd="123456"
project_dir="/var/www/html"
hash="$(openssl passwd -6 "${passwd}")"

# Create the group
if ! getent group developers >/dev/null; then
    groupadd -g 2000 developers
fi

# Create the user
if ! id -u "${username}" >/dev/null 2>&1; then 
    useradd -u 5000 -s /usr/bin/bash -g developers\
            -G sudo -p "${hash}" -m ${username}
fi

usermod -aG developers www-data
chage -d 0 ${username}
chmod -R 700 /home/${username}

# Set permissions for the project directory
if [ ! -d "${project_dir}" ]; then
    echo "${project_dir} not exists."
    exit 1
fi

chgrp -R developers "${project_dir}"
chmod -R 770 "${project_dir}"
chmod g+s "${project_dir}"

本地主机脚本

下方两个脚本均假设你使用的账户名为 akiyama。脚本 rsync_to_remote.sh 参考了我开发环境中的同步脚本，使用了 python 的虚拟环境。

注意

  • 使用下方脚本配置好免密登录后，请关闭远程服务器上 sshd 的密码登录权限，以提升安全性。
  • 脚本 generate_ssh_keysh.sh 中 33、34 行开头都各有一个 \t 制表符，复制下方脚本使用时请注意这一点。
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
#!/usr/bin/env sh
# Script Name: generate_ssh_key.sh
# Author: Aina
# Date Created: 2025-08-20 | Date Modified: 2025-09-16

# Exit immediately if a command exits with a non-zero status
# Treat unset variables as an error and exit immediately
set -eu

# Define variables
username="akiyama"
remote_host="192.168.1.2"
src="/var/www/html"
des="${username}@${remote_host}:/var/www/html"
key_file="${HOME}/.ssh/${username}_key"

# Check the directory
if [ ! -d "${HOME}/.ssh" ]; then
    mkdir -p "${HOME}/.ssh"
fi

# Generate the ssh key and copy to remote host 
if [ -f "${key_file}" ]; then
    echo "${key_file} already exist!"
else
    ssh-keygen -t ed25519 -C "Created by ${username}." -N "" -f "${key_file}"
fi

ssh-copy-id -o StrictHostKeyChecking=accept-new \
            -i "${key_file}" "${username}@${remote_host}"

cat >> ${HOME}/.ssh/config <<- EOF
    Match Host ${remote_host}, User ${username}
        IdentityFile ${key_file}
EOF

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
#!/usr/bin/env sh
# Script Name: rsync_to_remote.sh
# Author: Aina
# Date Created: 2025-09-02 | Date Modified: 2025-09-17

# Exit immediately if a command exits with a non-zero status
# Treat unset variables as an error and exit immediately
set -eu

# Difine variables
work_file="$(pwd)/${1:?Usage: ${0} WORKFILE}"
username="akiyama"
remote_host="192.168.1.2"
src="${work_file}site/"
des="${username}@${remote_host}:/var/www/html/"

# Check the File
if [ ! -d "${work_file}" -o ${#} -ne 1 ]; then
    echo "Usage: ${0} WORKFILE"
    exit 1
fi

# Start the venv
. mkdocs/bin/activate

# Start the build and clean
cd "${work_file}"
rm -rf "${src}"
echo "Start \`mkdocs build'."
mkdocs build

# Sync
rsync -rlcD -zvu --delete "${src}" "${des}"
rm -rf "${src}"
echo "All done."

故障排查

1. 网页无法访问

  • 问题描述：

    对服务器中的项目目录修改权限后，网页变得无法访问，返回 403 错误码。

  • 原因分析：

    Nginx 进程会继承启动时的用户组及权限，运行中的进程不会实时感知系统用户组的变更。

  • 解决方案：

    重启 Nginx 服务。

2. 网页加载异常

  • 问题描述：

    传输文件后，可以访问网页，但网页渲染异常。

  • 原因分析：

    通过 rsync 传输的文件，所属组会更新为用户的默认组，如果用户默认组不是 developers，Nginx 就无法正常访问资源文件。

  • 解决方案：

    修改开发者用户的默认组为 developers 后传输文件，或直接递归修改 /var/www/html 下文件的所属组。

3. rsync 提示错误

  • 问题描述：

    使用脚本同步本地与服务器项目文件时，rsync 提示权限不足，如：

    rsync: [generator] failed to set times on "/path/to/file": Operation not permitted (1)
rsync: [receiver] mkstemp "path/to/file" failed: Permission denied (13)

  • 原因分析：

    本节提供的脚本主要用于单用户进行文件同步。修改文件时间、创建临时文件的权限，只有文件或文件夹的所有者以及 root 用户拥有。在多用户环境下，哪怕属于同一个组，用户也没有权限对其他人的文件或文件夹进行修改文件时间、创建临时文件操作的。

  • 解决方案：

    本节提供的脚本并不满足你的需求，请自行进行更精细的权限管理。

附录：参考与连接

  1. 这里为了简化操作，没有给密钥设定密码。实际生产环境中，为了安全，建议设定密码并配合 ssh-agent 使用。 ↩