4 files changed, 139 insertions, 0 deletions
diff --git a/debian-container/lib/common.sh b/debian-container/lib/common.sh
new file mode 100644
index 0000000..1fd08b0
--- /dev/null
+++ b/debian-container/lib/common.sh
@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+# SPDX-License-Identifier: GPL-3.0-or-later
+# Copyright (C) 2026 by Richard Qin
+
+dc_die() {
+  echo "$*" >&2
+  exit 1
+}
+
+dc_require_root() {
+  [[ ${EUID} -eq 0 ]] || dc_die '请使用 sudo 执行此脚本。'
+}
+
+dc_require_commands() {
+  local tool
+  for tool in "$@"; do
+    command -v "$tool" >/dev/null || dc_die "缺少工具：$tool"
+  done
+}
+
+dc_acquire_lock() {
+  mkdir -p "$(dirname -- "$DC_LOCK_FILE")"
+  exec 9>"$DC_LOCK_FILE"
+  flock -n 9 || dc_die 'Debian 容器已经在运行或正在初始化。'
+}
+
+dc_usage() {
+  cat <<EOF
+用法：sudo bash $DC_SCRIPT <命令>
+
+命令：
+  init      创建 Debian 容器镜像
+  enter     进入容器
+  delete    删除容器镜像
+
+环境变量：
+  DEBIAN_IMAGE      镜像路径（默认：当前目录/rootfs.ext4）
+  DEBIAN_ROOT       挂载目录（默认：当前目录/debian-root）
+  DEBIAN_LOCK_FILE  锁文件路径
+EOF
+}
+
diff --git a/debian-container/lib/config.sh b/debian-container/lib/config.sh
new file mode 100644
index 0000000..66b1bfe
--- /dev/null
+++ b/debian-container/lib/config.sh
@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# SPDX-License-Identifier: GPL-3.0-or-later
+# Copyright (C) 2026 by Richard Qin
+
+# Keep runtime data in the directory from which the tool is invoked for now.
+# These variables can be overridden by the environment without changing the
+# command interface.
+DC_IMAGE=${DEBIAN_IMAGE:-"$PWD/rootfs.ext4"}
+DC_ROOT=${DEBIAN_ROOT:-"$PWD/debian-root"}
+DC_LOCK_FILE=${DEBIAN_LOCK_FILE:-/run/lock/debian-container.lock}
+
diff --git a/debian-container/lib/container.sh b/debian-container/lib/container.sh
new file mode 100644
index 0000000..759d798
--- /dev/null
+++ b/debian-container/lib/container.sh
@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+# SPDX-License-Identifier: GPL-3.0-or-later
+# Copyright (C) 2026 by Richard Qin
+
+dc_init() {
+  dc_require_commands debootstrap unshare mkfs.ext4 mount chroot setpriv flock
+
+  if [[ -e "$DC_IMAGE" ]]; then
+    dc_die "镜像已存在：$DC_IMAGE。请使用 enter 进入，避免覆盖容器数据。"
+  fi
+
+  mkdir -p "$(dirname -- "$DC_IMAGE")" "$DC_ROOT"
+  truncate -s 3G "$DC_IMAGE"
+  mkfs.ext4 -F -q -L DEBIAN_CONTAINER "$DC_IMAGE"
+  unshare --mount --propagation private -- bash "$DC_SCRIPT" _init
+  echo "初始化完成。执行 sudo bash $DC_SCRIPT enter 进入容器。"
+}
+
+dc_init_rootfs() {
+  dc_mount_root
+  trap dc_cleanup_mounts EXIT
+
+  debootstrap --variant=minbase stable "$DC_ROOT" http://deb.debian.org/debian
+  rm -f "$DC_ROOT/etc/resolv.conf"
+  cp -L /etc/resolv.conf "$DC_ROOT/etc/resolv.conf"
+  dc_mount_virtual_filesystems
+  chroot "$DC_ROOT" /usr/bin/env DEBIAN_FRONTEND=noninteractive /usr/bin/apt-get update
+  chroot "$DC_ROOT" /usr/bin/env DEBIAN_FRONTEND=noninteractive /usr/bin/apt-get install -y passwd util-linux vim-tiny e2fsprogs
+  echo debian-container > "$DC_ROOT/etc/hostname"
+}
+
+dc_enter() {
+  [[ -f "$DC_IMAGE" ]] || dc_die '没有找到镜像，请先运行 init。'
+
+  # 单独创建网络命名空间，暂时没有联网功能。
+  unshare --mount --uts --ipc --pid --net --fork --propagation private -- bash "$DC_SCRIPT" _enter
+}
+
+dc_enter_rootfs() {
+  dc_mount_root
+  trap dc_cleanup_mounts EXIT
+  dc_mount_virtual_filesystems
+  hostname debian-container
+  echo '已进入独立的 Debian 实验环境；输入 exit 可退出容器。'
+
+  # 完成挂载后撤销一些宿主级危险权限，保留 CAP_LINUX_IMMUTABLE。
+  setpriv --bounding-set=-sys_admin,-net_admin,-net_raw,-sys_module,-sys_boot,-sys_time,-sys_rawio,-sys_ptrace,-syslog -- \
+    chroot "$DC_ROOT" /bin/bash -l
+}
+
+dc_delete() {
+  [[ -f "$DC_IMAGE" ]] || { echo 'Debian 镜像已不存在。'; return 0; }
+  rm -- "$DC_IMAGE"
+  echo 'Debian 镜像已删除。'
+}
+
diff --git a/debian-container/lib/mount.sh b/debian-container/lib/mount.sh
new file mode 100644
index 0000000..0b623c8
--- /dev/null
+++ b/debian-container/lib/mount.sh
@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# SPDX-License-Identifier: GPL-3.0-or-later
+# Copyright (C) 2026 by Richard Qin
+
+dc_cleanup_mounts() {
+  umount "$DC_ROOT/dev/pts" 2>/dev/null || true
+  umount "$DC_ROOT/dev" 2>/dev/null || true
+  umount "$DC_ROOT/proc" 2>/dev/null || true
+  umount "$DC_ROOT" 2>/dev/null || true
+}
+
+dc_mount_root() {
+  mkdir -p "$DC_ROOT"
+  mount -o loop "$DC_IMAGE" "$DC_ROOT"
+  mkdir -p "$DC_ROOT/proc" "$DC_ROOT/dev"
+}
+
+dc_mount_virtual_filesystems() {
+  mount -t proc -o ro,nosuid,nodev,noexec proc "$DC_ROOT/proc"
+  mount -t tmpfs -o mode=0755,nosuid tmpfs "$DC_ROOT/dev"
+  mknod -m 0666 "$DC_ROOT/dev/null" c 1 3
+  mknod -m 0666 "$DC_ROOT/dev/zero" c 1 5
+  mknod -m 0666 "$DC_ROOT/dev/random" c 1 8
+  mknod -m 0666 "$DC_ROOT/dev/urandom" c 1 9
+  mknod -m 0666 "$DC_ROOT/dev/tty" c 5 0
+  mkdir -p "$DC_ROOT/dev/pts"
+  mount -t devpts -o newinstance,ptmxmode=0666,mode=0620 devpts "$DC_ROOT/dev/pts"
+  ln -s pts/ptmx "$DC_ROOT/dev/ptmx"
+}
+