在日本服务器的Linux系统中,如何用tar打包与解压并排除指定目录?

发布人:A5数据发布时间:2026-11-15 12:04阅读量:20

在日本服务器上运行 Linux 时,tar 的打包、解压和目录排除语法与其他地区的服务器基本一致。日常维护中,建议使用 -C 固定源目录,用 --exclude 排除缓存、临时文件或不需要进入备份的日志目录,并在生成后通过归档列表和压缩完整性检查确认结果。

例如,需要打包 /srv/www/site,但不包含 cache、runtime 两个目录,可以使用下面的命令:

sudo tar \
  --exclude='site/cache' \
  --exclude='site/runtime' \
  -czf /backup/site-20250115.tar.gz \
  -C /srv/www \
  -- site

其中,归档内的路径会以 site/ 开头,排除规则也必须按照归档内路径书写。/srv/www/site/cache 是服务器上的绝对路径,而 site/cache 才是上面这条命令对应的归档路径。

现状与条件确认

先确认 tar 类型和系统环境

Linux 发行版通常已经安装 GNU tar,但不同发行版或精简系统的参数支持可能存在差异。正式执行前,先确认当前使用的程序和版本:

command -v tar
tar --version | head -n 1
cat /etc/os-release
locale

如果输出中包含 GNU tar,本文示例中的 --exclude、--exclude-from、--acls、--xattrs 等参数通常可以直接使用。若系统返回的是其他实现,应先查看帮助信息:

tar --help | less

日本服务器的地域不会改变 tar 的归档逻辑,但以下两个因素需要单独确认:

  • 服务器上是否存在日文目录或文件名;
  • 归档文件名中的时间是使用服务器本地时区,还是统一使用日本标准时间。

可以查看当前时间和时区:

date '+%F %T %Z'
TZ=Asia/Tokyo date '+%F %T JST'

tar 通常不会替换文件名中的字符编码,而是按照文件系统返回的字节保存名称。若终端出现日文文件名显示异常,先检查当前终端和服务器的字符集:

locale charmap
find /srv/www/site -maxdepth 2 -print | sed -n '1,20p'

尽量在同一套 UTF-8 环境下进行打包和解压,不要为了修复显示问题而直接修改原文件名。

确认源目录、目标目录和可用空间

下面以这些路径作为示例:

  • 源目录:/srv/www/site
  • 备份目录:/backup
  • 解压测试目录:/srv/restore

实际操作时应替换成当前环境中的真实路径。先确认目录和空间:

sudo test -d /srv/www/site && echo "源目录存在"
sudo mkdir -p /backup
df -h /srv/www /backup
df -i /srv/www /backup
sudo du -sh /srv/www/site

df -h 用于查看可用容量,df -i 用于查看 inode。大量小文件可能在容量尚未用尽时先耗尽 inode,因此两项都要检查。

备份目录最好位于源目录之外。如果把归档文件直接写入正在打包的目录,例如:

/srv/www/site/backup/site.tar.gz

打包时可能把归档自身再次读入,导致文件持续增长、内容不完整或产生“文件在读取过程中发生变化”的提示。专用备份目录还应限制访问权限,避免网站源代码、配置文件或用户数据被普通账号读取。

确认是否有持续写入

网站程序、上传任务、日志服务和定时任务可能在打包过程中修改文件。持续写入会带来两类问题:

  1. 归档中的不同文件可能来自不同时间点;
  2. tar 读取某个文件时,文件大小或内容发生变化,命令返回非零状态。

如果备份用于恢复业务数据,应优先选择以下方式之一:

  • 在维护窗口暂停会写入目标目录的应用;
  • 暂停上传、导入或生成任务;
  • 使用文件系统快照后再从快照目录打包;
  • 对数据库使用数据库自身的导出工具,不要直接把正在运行的数据库数据目录当成普通文件打包。

如果只是备份可重新生成的静态文件,短时间内的文件变化可能可以接受,但仍应检查 tar 的退出状态,不要只看归档文件是否生成。

日常打包操作

tar 常用参数含义

常见的 gzip 压缩归档命令格式如下:

tar -czf archive.tar.gz source

参数含义如下:

参数含义作用
-ccreate创建归档
-xextract解压归档
-tlist列出归档内容
-zgzip使用 gzip 压缩或解压
-ffile指定归档文件
-Cchange directory在指定目录下解析后续源路径
--exclude排除规则不将匹配的路径加入归档
--exclude-from排除文件从文件中读取多条排除规则

tar 本身负责打包,gzip 负责压缩。.tar.gz 或 .tgz 只是常见的文件名后缀,不能仅凭后缀判断归档是否完整,仍应使用 tar -tzf 或 gzip -t 检查。

使用相对归档路径排除目录

假设目录结构如下:

/srv/www/site/
├── public/
├── config/
├── cache/
├── runtime/
├── logs/
└── uploads/
    └── tmp/

如果需要打包整个 site,但排除 cache、runtime 和临时上传目录,可执行:

sudo tar \
  --exclude='site/cache' \
  --exclude='site/runtime' \
  --exclude='site/uploads/tmp' \
  -czf /backup/site-20250115.tar.gz \
  -C /srv/www \
  -- site

这里的 -C /srv/www 表示让 tar 进入 /srv/www 后处理后面的 site。因此归档内的路径通常是:

日常打包操作 / 使用相对归档路径排除目录配图

site/
site/public/
site/config/
site/uploads/

而不是:

srv/www/site/

也不会使用服务器上的绝对路径 /srv/www/site/cache 作为匹配基准。

排除规则建议加上引号,避免 Shell 先处理通配符。对于整个目录,优先使用不带末尾斜杠的形式:

--exclude='site/cache'

如果只想排除某类文件,可以使用更具体的模式:

sudo tar \
  --exclude='site/cache' \
  --exclude='site/runtime' \
  --exclude='site/logs/*.log' \
  -czf /backup/site-20250115.tar.gz \
  -C /srv/www \
  -- site

site/logs/*.log 只排除匹配的日志文件,site/logs 目录本身和其他后缀的文件仍可能进入归档。是否排除日志,需要根据恢复目标决定:如果日志用于审计或故障分析,就不应把它排除。

采用临时文件,避免误用未完成归档

备份过程被中断时,目标文件可能已经存在,但并不代表它可以恢复。可以先使用 .part 后缀,检查成功后再改成正式名称:

ARCHIVE_PART="/backup/site-$(date +%Y%m%d-%H%M%S).tar.gz.part"
ARCHIVE="${ARCHIVE_PART%.part}"

if sudo tar \
  --exclude='site/cache' \
  --exclude='site/runtime' \
  --exclude='site/uploads/tmp' \
  -czf "$ARCHIVE_PART" \
  -C /srv/www \
  -- site
then
  if sudo gzip -t "$ARCHIVE_PART" && \
     sudo tar -tzf "$ARCHIVE_PART" >/dev/null
  then
    sudo mv -- "$ARCHIVE_PART" "$ARCHIVE"
    echo "归档完成:$ARCHIVE"
  else
    echo "压缩流或归档列表检查失败,保留未完成文件:$ARCHIVE_PART"
    exit 1
  fi
else
  echo "tar 执行失败,未将文件标记为正式归档:$ARCHIVE_PART"
  exit 1
fi

这段命令的判断顺序是:

日常打包操作 / 采用临时文件,避免误用未完成归档配图

  1. tar 返回成功;
  2. gzip -t 能读完整个 gzip 压缩流;
  3. tar -tzf 能完整读取归档目录;
  4. 以上条件都满足后,才将 .part 文件改名为正式归档。

如果 tar 报告文件在读取期间发生变化,即使 .part 文件能够生成,也不应直接改成正式备份名称。应先停止写入任务或采用快照后重新执行。

使用排除文件维护多条规则

排除项较多时,可以将规则放入独立文件:

cat > /tmp/site.exclude <<'EOF'
site/cache
site/runtime
site/uploads/tmp
site/logs/*.log
EOF

然后执行:

sudo tar \
  --exclude-from=/tmp/site.exclude \
  -czf /backup/site-20250115.tar.gz \
  -C /srv/www \
  -- site

排除文件中的每一行都是匹配模式。规则仍然按照归档内路径书写,不是按照当前 Shell 的工作目录书写。建议先用 tar -tzf 查看归档路径,再据此调整排除文件。

排除文件本身可能包含业务路径信息。如果服务器上存在多个维护账号,应限制该文件的读取权限,并在任务完成后按实际保留策略处理临时文件。

需要保留 ACL、扩展属性和数字属主时

普通网站文件通常需要保留权限、目录结构和符号链接。如果环境还依赖 ACL、扩展属性或文件能力,可以在 GNU tar 中显式加入相关参数:

sudo tar \
  --acls \
  --xattrs \
  --numeric-owner \
  --exclude='site/cache' \
  --exclude='site/runtime' \
  -czf /backup/site-20250115.tar.gz \
  -C /srv/www \
  -- site

--numeric-owner 会记录 UID 和 GID 数字,而不是只记录用户名和组名。它适合在不同服务器之间迁移文件,但恢复到另一台服务器后,数字 UID 未必对应同名用户,需要在解压后检查属主。

不要随意使用 -h 或 --dereference。默认情况下,tar 通常保存符号链接本身;使用该参数后,符号链接指向的实际文件可能被跟随并复制,归档范围和大小都可能超出预期。

解压前的结果检查

先查看归档目录,不要直接覆盖生产目录

解压前先列出归档内容:

sudo tar -tzf /backup/site-20250115.tar.gz | sed -n '1,40p'

查看带有权限、属主和大小的信息:

sudo tar -tvzf /backup/site-20250115.tar.gz | sed -n '1,40p'

确认被排除的目录没有进入归档:

sudo tar -tzf /backup/site-20250115.tar.gz \
  | grep -E '^site/(cache|runtime|uploads/tmp)(/|$)' \
  || echo "未发现指定排除目录"

如果命令没有输出匹配路径,并且显示“未发现指定排除目录”,说明这些规则在当前归档路径下没有匹配到内容。若仍然发现排除目录,重点检查以下内容:

  • 归档路径是否以 site/ 开头;
  • 排除规则是否误写成 /srv/www/site/cache;
  • 是否在其他路径下还存在同名目录;
  • 实际归档是否由另一条命令生成;
  • --exclude 是否放在源路径之后,导致命令结构不清晰。

还可以检查是否存在绝对路径或父目录跳转项:

sudo tar -tzf /backup/site-20250115.tar.gz \
  | grep -E '(^/|(^|/)\.\.)' \
  || echo "未发现绝对路径或父目录跳转项"

不应只根据文件名后缀判断归档可用。至少执行:

sudo gzip -t /backup/site-20250115.tar.gz
sudo tar -tzf /backup/site-20250115.tar.gz >/dev/null
echo $?

最后的退出码为 0,表示列表读取成功。非零退出码表示压缩流、归档结构或读取过程存在问题。

解压到测试目录

常规解压

先创建权限合适的测试目录:

sudo install -d -m 0750 /srv/restore

然后解压:

sudo tar \
  --acls \
  --xattrs \
  -xzf /backup/site-20250115.tar.gz \
  -C /srv/restore

如果归档内的根目录是 site/,解压后通常得到:

/srv/restore/site/

-C 只改变解压目标目录,不会改变归档中原有的目录层级。解压后检查:

sudo find /srv/restore/site -maxdepth 2 -print | sed -n '1,40p'
sudo du -sh /srv/restore/site

在解压阶段再次排除目录

如果归档已经生成,但只想恢复其中一部分内容,也可以在解压时排除:

sudo tar \
  --exclude='site/cache' \
  --exclude='site/runtime' \
  -xzf /backup/site-20250115.tar.gz \
  -C /srv/restore

解压阶段的排除规则仍然匹配归档内的名称,而不是目标目录的绝对路径。若归档中显示的是 ./site/cache/,而规则写成了其他前缀,就可能无法达到预期,因此应以 tar -tzf 的实际输出为准。

解压到指定目录并去掉一层目录

如果归档结构是:

site/
site/index.html
site/config/
site/public/

但希望把 index.html 直接解压到 /srv/restore/site/,可以使用:

sudo install -d -m 0750 /srv/restore/site

sudo tar \
  --strip-components=1 \
  -xzf /backup/site-20250115.tar.gz \
  -C /srv/restore/site \
  -- site

--strip-components=1 会去掉归档路径的第一层 site。该参数会改变目录结构,使用前必须先确认归档根目录确实只有这一层,否则可能把文件解压到错误位置。

控制是否覆盖已有文件

在空的测试目录中解压通常最容易判断结果。如果目标目录已有文件,可考虑使用:

sudo tar \
  --keep-old-files \
  -xzf /backup/site-20250115.tar.gz \
  -C /srv/restore

--keep-old-files 遇到同名文件时会报错,不会直接覆盖已有文件。它适合保护测试目录或临时恢复目录,但如果目标目录中本来就有大量文件,命令可能因为冲突而无法完整完成。

在不同服务器之间恢复时,如果不需要保留归档中的原属主,可以使用:

sudo tar \
  --no-same-owner \
  -xzf /backup/site-20250115.tar.gz \
  -C /srv/restore

这个选项会让解压后的文件归当前执行用户或默认属主。恢复网站时,仍需根据实际服务账号重新检查权限,不要为了绕过权限问题直接执行 chmod -R 777。

结果检查与判断标准

解压完成后,可以从文件数量、关键文件、权限和排除项四个方面检查。

sudo test -f /srv/restore/site/index.html \
  && echo "关键入口文件存在" \
  || echo "未找到关键入口文件"

sudo find /srv/restore/site -type f | wc -l
sudo stat -c '%U:%G %a %n' /srv/restore/site/index.html
sudo du -sh /srv/restore/site

如果源目录在打包期间没有发生变化,可以进行目录差异检查:

diff -qr \
  --exclude=cache \
  --exclude=runtime \
  --exclude=tmp \
  /srv/www/site \
  /srv/restore/site

diff 没有输出通常表示比较范围内没有发现差异;如果有输出,应区分以下情况:

  • 归档时源文件正在写入;
  • 某些目录本来就被排除;
  • 解压时使用了 --strip-components;
  • 文件属主、权限或符号链接状态不同;
  • 解压目标不是预期路径。

关键检查项和判断标准可以按下面方式记录:

检查项目检查命令合格标准
压缩流gzip -t archive.tar.gz返回码为 0
归档结构tar -tzf archive.tar.gz >/dev/null能完整列出且返回码为 0
排除目录tar -tzf ... | grep ...不出现指定排除路径
根目录tar -tzf ... | sed -n '1,20p'目录层级符合预期
关键文件test -f path入口文件或配置文件存在
文件数量find path -type f | wc -l与备份范围和排除项相符
权限属主stat -c '%U:%G %a %n' path符合应用账号访问要求
空间df -h、df -i容量和 inode 都有余量

如果归档用于网站上线前的替换,还需要在测试目录中启动或指向测试配置进行应用级验证。文件能够成功解压,只能证明归档结构可读,并不等同于应用配置、运行时目录和服务依赖都正确。

常见异常处理

排除目录仍然出现在归档中

先直接查看归档中的实际路径:

sudo tar -tzf /backup/site-20250115.tar.gz \
  | grep -E 'cache|runtime|tmp'

如果输出类似:

site/public/cache/
site/runtime/

说明 site/runtime 规则只排除了一个路径,site/public/cache 仍是另一处目录。此时应根据备份边界决定是否增加规则:

--exclude='site/public/cache'

如果希望排除所有名为 cache 的目录,应谨慎使用范围更大的模式,因为可能误排除业务数据:

--exclude='cache'

这种宽泛规则必须通过归档列表确认,不能只凭命令执行成功判断。

出现 “file changed as we read it”

这通常表示文件在打包过程中被修改。首先检查是否有日志、上传、缓存刷新或部署任务正在运行。若备份要求一致性,停止相关写入后重新执行;如果不能停机,则使用快照或应用层导出方案。

不要用忽略警告的方式掩盖问题。归档文件即使存在,也可能只包含修改前后的混合状态。

出现 “Cannot stat” 或 “Permission denied”

Cannot stat 通常表示源路径写错、挂载点未挂载或文件在命令执行前已经被移动。可以检查:

sudo ls -ld /srv/www /srv/www/site
sudo namei -l /srv/www/site
mount | grep -E '/srv/www|/srv'

Permission denied 需要分别确认目录搜索权限、文件读取权限和 ACL。若确实需要管理员权限,可使用 sudo tar,但不要为了打包临时把整个网站目录改成可写或 777。

出现 “No space left on device”

检查容量和 inode:

df -h /backup
df -i /backup
sudo du -xhd1 /backup | sort -h

归档输出应放在有足够空间的独立文件系统上。不要直接删除不确定用途的旧备份;先确认文件名、保留周期和是否存在异地副本。当前使用 .part 文件也可以避免其他任务误把未完成归档当作有效备份。

面向网站文件归档与存储需求,A5idc数据提供日本地区物理服务器方案,涵盖Xeon Gold、AMD EPYC平台,以及NVMe、SSD和大容量HDD配置。日本CTG系列部分方案配备三块16TB HDD或多块SSD,可为网站文件、备份归档及相关运维数据提供存储资源,也可结合服务器计算配置承载打包与文件管理任务。

日文文件名显示异常

先确认服务器和终端的字符集:

locale
locale charmap

再用 Shell 的引号保护路径:

sudo tar -czf /backup/site.tar.gz -C /srv/www -- "site/公開"

归档保存的是文件系统中的名称字节,终端乱码不一定意味着归档中的文件名已经损坏。可以在同一台服务器上先解压到测试目录,再用 find 和 stat 检查实际名称。

解压后文件层级不对

如果得到的是:

/srv/restore/srv/www/site/

通常说明打包时把过长的路径作为源路径传入。日常备份建议使用:

tar -czf /backup/site.tar.gz -C /srv/www -- site

而不是直接把 /srv/www/site 作为源参数。恢复时不要立即使用 --strip-components 盲目修正,先用 tar -tzf 确认归档的根层级。

归档来自不可信来源

不明来源的归档可能包含异常路径、符号链接或会覆盖现有文件的同名项。先在非生产目录中查看:

sudo tar -tzf /path/to/unknown.tar.gz | sed -n '1,100p'

确认内容后再以低权限账号解压。对于需要管理员权限的恢复,应先使用独立测试目录验证,避免直接覆盖网站根目录或系统配置目录。

必要恢复与上线前处理

归档失败时的处理

.part 文件只能视为临时产物。若 tar 返回非零状态、gzip -t 失败或 tar -tzf 无法列出内容,就不要将其用于恢复。

重新执行前确认:

  • 源目录仍然存在;
  • 备份目标空间充足;
  • 相关写入任务已停止或已准备快照;
  • 上一次失败归档不会与新文件混淆;
  • 正式归档仍然保留,没有被错误覆盖。

用暂存目录替换现有网站

不要直接把归档解压到正在提供服务的目录上。更安全的流程是先解压到暂存目录,完成文件和应用检查后,再在维护窗口内切换。

切换前应保留当前目录作为回滚副本。下面是示例流程,路径、服务名和应用账号必须替换为真实值:

必要恢复与上线前处理 / 用暂存目录替换现有网站配图

LIVE="/srv/www/site"
STAGED="/srv/restore/site"
OLD="/srv/www/site.before-restore-$(date +%Y%m%d-%H%M%S)"

sudo test -d "$LIVE"
sudo test -d "$STAGED"

sudo mv -- "$LIVE" "$OLD"
if sudo mv -- "$STAGED" "$LIVE"; then
  echo "切换完成,旧目录保留为:$OLD"
else
  echo "新目录切换失败,开始恢复旧目录"
  sudo mv -- "$OLD" "$LIVE"
  exit 1
fi

这组操作会改变线上目录名称,影响正在运行的应用,因此需要满足以下前提:

  • 已进入维护窗口;
  • 已确认同一文件系统上的 mv 行为符合当前部署方式;
  • 已在暂存目录完成入口文件、配置文件和权限检查;
  • 已准备好应用服务的重启或重新加载步骤;
  • 旧目录尚未删除,并且空间足够保留回滚副本。

如果新目录切换后出现异常,可以先停止应用写入,再将当前目录改名,将 OLD 目录移回原路径:

sudo mv -- /srv/www/site /srv/www/site.failed
sudo mv -- /srv/www/site.before-restore-20250115-143000 /srv/www/site

回滚命令中的时间戳必须替换为实际保留的旧目录名称。不要直接执行模糊匹配或批量删除,以免误删其他版本。

被排除目录的恢复边界

排除 cache、临时目录或日志后,归档并不再是完整副本。恢复时,这些目录可能需要重新创建,并设置应用账号能够访问的权限:

sudo install -d -m 0750 /srv/www/site/cache
sudo install -d -m 0750 /srv/www/site/runtime

如果应用使用专用账号运行,应先确认其真实属主和组名,再执行权限调整:

stat -c '%U:%G %a %n' /srv/www/site
id appuser

不要假设所有应用都可以安全地重新生成 runtime 或 uploads/tmp。缓存通常可以重建,但上传临时目录中可能存在尚未完成处理的用户文件,是否排除需要结合业务流程确认。

上线或验收检查清单

  • [ ] 已确认 tar 类型和版本,命令参数与当前 Linux 环境兼容。
  • [ ] 已确认源目录、备份目录和解压目录,备份输出不在源目录内部。
  • [ ] 已检查 df -h 和 df -i,容量与 inode 均有余量。
  • [ ] 已确认应用写入任务、上传任务和数据库处理方式。
  • [ ] 已明确哪些目录可以排除,缓存、日志和临时目录没有误包含业务数据。
  • [ ] --exclude 使用的是归档内相对路径,并已用 tar -tzf 核对。
  • [ ] 打包命令返回成功,没有出现文件变化、权限或空间错误。
  • [ ] gzip -t 检查通过。
  • [ ] tar -tzf 能完整列出归档内容。
  • [ ] 归档中不存在不应出现的绝对路径或父目录跳转项。
  • [ ] 已先解压到暂存目录,没有直接覆盖生产目录。
  • [ ] 已验证入口文件、关键配置文件、文件数量和权限属主。
  • [ ] 已明确 --strip-components 是否会改变目录层级。
  • [ ] 被排除目录已按实际需要重新创建或确认不需要。
  • [ ] 上线切换前已保留当前目录作为回滚副本。
  • [ ] 切换后已检查应用进程、网站响应、日志和关键功能。
  • [ ] 正式归档、旧目录和回滚路径均有清晰的保留标识。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9563.html

相关推荐