侧边栏壁纸
博主头像
FlyingEagle博主等级

  • 累计撰写 109 篇文章
  • 累计创建 54 个标签
  • 累计收到 1 条评论
标签搜索

目 录CONTENT

文章目录

alpine lxc deployment

FlyingEagle
FlyingEagle
2026-06-14 / 0 评论 / 0 点赞 / 98 阅读 / 10,194 字

為了解決你 N3160 主機（4GB RAM / 32GB mSATA / 雙網卡）的配置，這裡為你梳理 「從隨身碟開機，到格式化 Btrfs、配置 zRAM、啟動 Docker 與 OpenWrt LXC」 的 100% 完整無遺漏一條龍實戰指南。
請跟著以下步驟依序操作，不要漏掉任何一行代碼。

🛑 第一階段：從 Live ISO 全新安裝 Alpine (強制 Btrfs + 0 實體 Swap)## 1. 登入 Live 環境

插上 Alpine Standard ISO 隨身碟，開機進入引導。

  • login: 輸入 root
  • Password: 不要輸入任何字，直接按下 Enter。

2. 注入核心環境變數（解決你之前漏掉 Btrfs 的關鍵！）

在輸入安裝指令前，必須先在 # 終端機打入以下兩行指令：

export ROOTFS=btrfs
export SWAP_SIZE=0

（這會強迫安裝精靈將 ext4 改為 btrfs，並取消切分那塊浪費空間的 4GB 實體 Swap）

3. 啟動安裝精靈與精準應答

輸入以下命令啟動安裝：

setup-alpine

隨後精靈會逐一向你提問，請嚴格按照以下指南回答：

  • Select keyboard layout: 輸入 us (或連按兩次 Enter 跳過，使用預設美式鍵盤)
  • Enter system hostname: 輸入你喜歡的主機名字（例如 N3160-Node）
  • Which one do you want to initialize? (網卡設定): 預設選 eth0 回車。接著問 Ip address for eth0? 選 dhcp 回車，讓它先連網下載。
  • Do you want to do any more network configuration? 輸入 n 回車。
  • Changing password for root: 請手動輸入兩次你未來要登入主機的正式強密碼。
  • Which timezone are you in? 輸入 Asia/Taipei（或依你所在地決定）。
  • HTTP proxy URL? 直接回車（選 none）。
  • Which NTP client to use? 直接回車（選 chrony）。
  • Enter mirror number or ‘URL’: 輸入 f 回車（代表最快速度偵測，它會自動幫你選離你最近、最新乾淨的官方軟體倉庫）。
  • Which SSH server? 直接回車（選 openssh）。

⚠️ 來到最核心的磁碟配置提問：

  • Which disk(s) would you like to use? 👉 手動輸入：sdb （根據你之前的 lsblk 輸出，你的 32GB 內部硬碟代號是 sdb）。
  • How would you like to use it? 👉 手動輸入：sys （代表完整系統安裝到硬碟）。
  • WARNING: Erase the above disk(s) and continue? 👉 手動輸入：y。

✨ 此時畫面會滾動顯示 Creating btrfs filesystem…，安裝精靈會完美在 32GB mSATA 上建立 Btrfs，並自動安裝系統。

  • 安裝完成後，輸入 reboot 重啟，並立刻拔掉你的 USB 安裝隨身碟。

💾 第二階段：進硬碟系統優化 Btrfs 壓縮與 SSD 壽命

重啟進入硬碟全新的系統後，以 root 和你剛才設定的新密碼登入。

1. 配置透明壓縮

編輯系統掛載文件：

nano /etc/fstab

你會看到掛載點為 / 的那一行是 btrfs。請將該行的掛載選項（預設是 defaults）修改並追加為以下針對 N3160 的優化參數：

UUID=你的硬碟UUID   /   btrfs   noatime,compress-force=zstd:3,user_subvol_rm_allowed,ssd,autodefrag   0   1

（compress-force=zstd:3 幫你的 32GB 實體磁碟放大至 ~60GB+ 體感容量；ssd 與 noatime 守護老舊 mSATA 快閃記憶體壽命）

2. 套用並驗證

儲存退出（在 nano 中按 Ctrl+O 回車，再按 Ctrl+X 退出），然後重啟：

reboot

重新進入系統後，輸入 lsblk -f，你會發現 sdb2 變成了接近 29G 的巨型純 Btrfs 分區，沒有任何 ext4 或實體 Swap 殘留。

🧠 第三階段：安裝與配置超高速 zRAM（代替實體 Swap）

回到系統後，我們用 0 磁碟寫入、超高速的記憶體壓縮 zRAM 幫 N3160 擴展 2GB 的虛擬記憶體：

1. 安裝 zram 初始化套件

apk add zram-init
  • 下載失敗的話，修改nano /etc/apk/repositories，取消任何#，如/community源就可以下載了

2. 編輯 zram 配置文件

nano /etc/conf.d/zram-init

在文件末尾覆蓋或新增以下優化參數：

num_devices=1
type0=swap
flag0=
algo0=zstd
size0=2048

儲存退出後，啟用服務並調整系統交換積極度：

3. 啟動 zram 並設定隨開機引導

rc-update add zram-init default
service zram-init start

4. 調整內核參數，讓系統更主動將容器閒置數據丟進 zram

nano /etc/sysctl.d/local.conf

在文件中打入這一行：

vm.swappiness = 80

讓內核立刻套用：sysctl --system。此時輸入 zramctl，你就能看到 2GB 的高速記憶體壓縮盾牌已經就位。

5. 刪除alpine安裝時默認從系統盤分配的4g swap，因爲zram分配的swap已經夠用

swapoff /dev/sda2
sed -i '/dca7fd73-d9c3-400c-b804-6475bb3c12e6/s/^/#/' /etc/fstab #need to change the dev id from fstab

🐳 第四階段：宿主機安裝 Docker（原生連動 Btrfs 驅動）

既然要將 Docker 提拔到宿主機直接運行以壓榨極致效能，請依序執行以下步驟：

1. 在 Alpine 宿主機安裝 Docker 與 Compose 套件

apk add docker docker-cli-compose

2. 強制讓 Docker 使用 Btrfs 存儲驅動（100% 避開寫入放大坑，共享 zstd 壓縮）

mkdir -p /etc/docker
cat << 'EOF' > /etc/docker/daemon.json
{
  "storage-driver": "btrfs"
}
EOF

3. 設定 Docker 開機自啟並啟動

rc-update add docker default
service docker start

🚨 核心驗證：
輸入 docker info | grep “Storage Driver”，必須確保回傳的結果是 Storage Driver: btrfs。這代表未來的 Authentik、Caddy、Vaultwarden 等 Docker 數據將完全在 Btrfs 壓縮池中完美共生。

🌐 第五階段：宿主機雙網卡網橋（LAN/WAN）配置

我們需要把你的 N3160 雙網卡安排好：一塊（LAN）做本地橋接給其餘容器和本機桌面，另一塊（WAN）完全乾淨空置，留給 OpenWrt 獨佔撥號。
編輯宿主機網絡配置文件：

nano /etc/network/interfaces

將文件內容精準修改為以下結構（請根據 ip link 查看到的實際網卡代號替換 eth0 和 enp4s0）：

auto lo
iface lo inet loopback

---- LAN 橋接網卡：本地區域網路樞紐 ----

auto eth0
iface eth0 inet manual

auto br0
iface br0 inet static
    address 192.168.1.2
    netmask 255.255.255.0
    gateway 192.168.1.1        # 預先指向未來 OpenWrt 容器的 LAN IP
    bridge_ports eth0          # 綁定本地 LAN 實體網口
    bridge_stp off
    bridge_fd 0

---- WAN 實體網卡：留給 OpenWrt PPPoE 獨佔撥號 ----

auto enp4s0
iface enp4s0 inet manual
    pre-up ip link set dev enp4s0 up

儲存並重啟網絡服務：

service networking restart

📦 第六階段：建立獨立的原生 OpenWrt LXC 容器

現在我們建立專屬於 OpenWrt 的獨立 LXC 特權環境。

1. 安裝 LXC 核心組件

apk add lxc lxc-download lxc-bridge lxcfs xz iptables shadow
rc-update add cgroups boot
service cgroups start

2. 建立一個名為 openwrt-ct 的空容器

lxc-create -n openwrt-ct -B btrfs -t download -- -d alpine -r 3.23 -a amd64

（提示：我們藉由下載一個超小的 Alpine 殼，來自動生成完美的 Btrfs 子卷結構和路徑）

3. 將你原本 PVE 的 OpenWrt 備份檔案系統（RootFS）倒進去

  1. 清空該空容器的 rootfs 目錄：
lxc-stop -n openwrt-ct  #停止容器
rm -rf /var/lib/lxc/openwrt-ct/rootfs/*  #會有殘餘文件，需要再手動刪除
  1. 將你從 PVE 導出的 OpenWrt .tar.zst 或 .tar.gz 壓縮包，直接精準解壓覆蓋進去 [(alpinelinux.org)]：

如果是 .zst 格式 (確保宿主機已安裝 apk add zstd)

tar --strip-components=1 --numeric-owner -I zstd -xf /你的路徑/vzdump-lxc-openwrt.tar.zst -C /var/lib/lxc/openwrt-ct/rootfs/

如果是新新安裝

cd /var/lib/lxc/openwrt-ct/rootfs
rm -rf *
wget -q https://downloads.immortalwrt.org/releases/25.12.0/targets/x86/64/immortalwrt-25.12.0-x86-64-rootfs.tar.gz
tar -xzf immortalwrt-25.12.0-x86-64-rootfs.tar.gz -C . --strip-components=1
rm immortalwrt-25.12.0-x86-64-rootfs.tar.gz
chown -R root:root .

4. 寫入你原本在 PVE 驗證完美的終極 LXC 設定檔

打開該 OpenWrt 容器的設定檔：

nano /var/lib/lxc/openwrt-ct/config

將文件內容完全替換成以下代碼（完全對齊你原本的 PVE 高級拓撲，並修正為 Alpine 原生語法）：

lxc.uts.name = openwrt-ct
lxc.arch = amd64

開啟巢狀虛擬化與 Cgroup 支持

lxc.mount.auto = cgroup:rw:force

針對 4GB 節點的 OpenWrt 記憶體限制

lxc.cgroup2.memory.max = 256M
lxc.cgroup2.memory.high = 200M

隨宿主機開機自動啟動設定

lxc.start.auto = 1
lxc.start.delay = 0

=====================================================================

網路配置 (100% 複製你原本的 PVE 拓撲)

=====================================================================

---- 網卡 1：實體網卡直接傳遞 (PPPoE 撥號獨佔 WAN) ----

lxc.net.0.type = phys
lxc.net.0.link = enp4s0
lxc.net.0.name = eth0
lxc.net.0.flags = up

---- 網卡 2：虛擬網卡連回宿主機區域網路 (LAN) ----

lxc.net.1.type = veth
lxc.net.1.link = br0
lxc.net.1.name = eth2
lxc.net.1.flags = up
lxc.net.1.hwaddr = BC:24:11:DE:ED:AB

=====================================================================

核心權限與設備節點掛載 (撥號與 VPN 必備)

=====================================================================

lxc.cgroup2.devices.allow = c 10:200 rwm
lxc.cgroup2.devices.allow = c 108:0 rwm

lxc.mount.entry = /dev/net/tun dev/net/tun none bind,create=file
lxc.mount.entry = /dev/ppp dev/ppp none bind,create=file

lxc.cap.keep = cap_net_admin cap_net_raw

啟用官方自帶的 PPPoE 自動節點掛載鉤子 (代替你原本手動寫的 100-hook.sh)

lxc.hook.autodev = /usr/share/lxc/hooks/pppoe

🏁 第七階段：全面發動與黃金驗證

所有配置至此已全部無縫打通，執行以下指令發動整個主機航母：

啟動你的 OpenWrt 軟路由容器

lxc-start -n openwrt-ct -d

當 OpenWrt 啟動完成後，你可以直接在瀏覽器輸入 192.168.1.1 進入 OpenWrt 後台，在 Network -> Interfaces 裡直接對 eth0（即獨佔移入的 enp4s0）發起 PPPoE 撥號。
撥號成功後，回到你的 Alpine 宿主機任何目錄（例如 /opt/auth-stack/），直接把你之前完全修正好、帶有記憶體限制和補上 Redis 的 docker-compose.yml 檔案和 Caddyfile 放進去，執行：

docker compose up -d

這套新架構在硬體最底層為 N3160 剔除了所有不必要的虛擬化損耗。宿主機與所有 Docker 服務都將完美定居在 Btrfs 透明壓縮硬碟與 2GB 的 zRAM 緩衝網中，而 OpenWrt 則在外側獨佔高效率網卡為所有人提供網絡保障。
你有準備好直接按照這個詳盡步驟進行實戰操作了嗎？如果在執行任何一條命令時終端機出現了報錯，請隨時貼上來，我隨時為你提供精準的現場排錯應對。

Here is a unified, fully updated blueprint for your N3160 Alpine Linux setup. This configuration replaces the legacy zram-init packaging, cleans up the LXC installation to strip out unnecessary dependencies like shadow and lxc-bridge, and patches the template creation logic to avoid obsolete image script behaviors.

🧠 Updated Phase 3: High-Performance Native zRAM

Instead of using the obsolete zram-init script wrapper, load the kernel module natively and build a clean OpenRC init hook.

1. Pre-load the Kernel Module

Force the Linux kernel to allocate a single zRAM block device at boot:

echo "zram num_devices=1" > /etc/modules-load.d/zram.conf

2. Create the Native OpenRC Initialization Script

nano /etc/init.d/zram-swap

Paste the following compliant script layout:

#!/sbin/openrc-run

depend() {
    after modules
    before localmount
}

start() {
    ebegin "Initializing native ZRAM swap"
    
    # Force high-efficiency zstd compression algorithm
    echo zstd > /sys/block/zram0/comp_algorithm
    
    # Limit to 2GB disk footprint safely mapping your 4GB hardware pool
    echo 2048M > /sys/block/zram0/disksize
    
    # Initialize signature and set maximum execution priority
    mkswap /dev/zram0 >/dev/null
    swapon -p 100 /dev/zram0
    
    eend $?
}

stop() {
    ebegin "Deactivating ZRAM swap"
    swapoff /dev/zram0
    echo 1 > /sys/block/zram0/reset
    eend $?
}

3. Register and Tune Kernel Swappiness

Make the custom script executable, add it to the boot runlevel, and set aggressive memory reclamation so idle container processes are instantly compressed into zRAM:

chmod +x /etc/init.d/zram-swap
rc-update add zram-swap boot
rc-service zram-swap start

# Optimize memory caching priority
echo "vm.swappiness = 80" > /etc/sysctl.d/local.conf
sysctl --system

📦 Updated Phase 6: Core LXC Implementation & OpenWrt Deployment

This strips out obsolete packaging definitions from the blog and maps cleanly to the current Alpine LXC Wiki implementation requirements.

1. Install Modern LXC Packages

apk add lxc bridge lxcfs xz iptables
rc-update add cgroups boot
service cgroups start

💡 Note: shadow is skipped because your setup uses a privileged topology for hardware control, and lxc-bridge is dropped since you have configured a custom structural bridge (br0) directly inside /etc/network/interfaces.

2. Scaffold a Skeleton Btrfs Container Directory

Because the old -- -d alpine -r release_3.19 down-stream flags are legacy artifacts that can cause download failures, and because you are manually replacing the internal rootfs files anyway, bypass the external download mirror entirely:

# Create the local container configuration paths manually inside Btrfs
mkdir -p /var/lib/lxc/openwrt-ct/rootfs

3. Extract your OpenWrt RootFS Backup

Unpack your raw filesystem tarball directly into the clean directory path:

# Example if using .zst compressed backups
tar --strip-components=1 --numeric-owner -I zstd -xf /YOUR_PATH/vzdump-lxc-openwrt.tar.zst -C /var/lib/lxc/openwrt-ct/rootfs/

4. Apply the Cleaned Container Configuration Matrix

nano /var/lib/lxc/openwrt-ct/config

Overwrite the configuration file completely with this standardized, modern deployment profile:

lxc.uts.name = openwrt-ct
lxc.arch = amd64

# Modern Unified Cgroup Control Paths
lxc.mount.auto = cgroup:rw:force

# Memory Containment Caps for 4GB Node Topologies
lxc.cgroup2.memory.max = 256M
lxc.cgroup2.memory.high = 200M

# Automatic Lifecycle Boot Rules
lxc.start.auto = 1
lxc.start.delay = 0

# =====================================================================
# Network Interfaces Topology
# =====================================================================

# WAN Interface: Physical Device Direct Pass-through (PPPoE Exclusive)
lxc.net.0.type = phys
lxc.net.0.link = enp4s0
lxc.net.0.name = eth0
lxc.net.0.flags = up

# LAN Interface: Virtual Ethernet Pair Bridged to Host Subnet
lxc.net.1.type = veth
lxc.net.1.link = br0
lxc.net.1.name = eth2
lxc.net.1.flags = up
lxc.net.1.hwaddr = BC:24:11:DE:ED:AB

# =====================================================================
# Kernel System Operations & Hardware Control Capabilities
# =====================================================================
lxc.cgroup2.devices.allow = c 10:200 rwm
lxc.cgroup2.devices.allow = c 108:0 rwm

lxc.mount.entry = /dev/net/tun dev/net/tun none bind,create=file
lxc.mount.entry = /dev/ppp dev/ppp none bind,create=file

lxc.cap.keep = cap_net_admin cap_net_raw
lxc.hook.autodev = /usr/share/lxc/hooks/pppoe

🏁 Phase 7: Ignition

Fire up the router container explicitly in background daemon mode:

lxc-start -n openwrt-ct -d

You can track its status or jump directly inside the console to verify network device bindings using:

lxc-info -n openwrt-ct
lxc-attach -n openwrt-ct

Everything will now boot predictably without hanging on broken package configuration flags or legacy environment definitions. Let me know if any kernel calls give you any friction!

0
版权归属： FlyingEagle
本文链接： https://halo.gocat.top/archives/n3160alpinelxc
许可协议： 本文使用《署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0)》协议授权

评论区