System Preparation and Repository Configuration
# Backup current repository configuration
sudo cp /etc/apt/sources.list /etc/apt/sources.list.backup
# Update to mirror repository
sudo bash -c 'cat > /etc/apt/sources.list' << EOF
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu-ports/ jammy main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu-ports/ jammy-updates main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu-ports/ jammy-backports main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu-ports/ jammy-security main restricted universe multiverse
EOF
# Update package lists
sudo apt-get update
# Remove obsolete packages
sudo apt-get autoremove
# Clean package cache
sudo apt-get clean
If you encounter GPG key verification errors during update, manual import the missing key:
gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 871920D1991BC93C
gpg --export --armor 871920D1991BC93C | sudo apt-key add -
HomeAssistant Installation and Configuration
# Pull the latest HomeAssistant image
docker pull homeassistant/home-assistant:stable
# Create and run the container
docker run -d --restart=always --name="homeassistant" \
-v /homeassistant_data/config:/config \
-p 8123:8123 \
homeassistant/home-assistant:stable
# Access container and install HACS
docker exec -it homeassistant bash
mkdir -p /config/custom_components/hacs
cd /config/custom_components/hacs
# Download HACS (requires internet access)
wget -O - https://get.hacs.xyz | bash
# Extract and restart
unzip hacs.zip
exit
docker restart homeassistant
Docker and CasaOS Installation
# Docker installation (skipped if installing CasaOS)
sudo apt-get install docker.io -y
# CasaOS installation
wget -qO- https://get.casaos.io | bash
# Install text editor
sudo apt-get install nano -y
Alist File Manager Setup
# Manual Alist installation with media mounting
docker run -d --restart=always \
-v /etc/alist:/opt/alist/data \
-v /media:/media \
-p 5244:5244 \
-e PUID=0 -e PGID=0 -e UMASK=022 \
--name="alist" \
xhofe/alist:latest
# Set admin password
docker exec -it alist ./alist admin set YourSecurePassword123
Qinglong Panel Installation
# Pull and run Qinglong container
docker pull whyour/qinglong:latest
docker run -tid \
--name qinglong \
-p 5700:5700 \
--restart always \
whyour/qinglong:latest
ZeroTier Network Configuration
First, create an account and network on the ZeroTier website.
# Deploy ZeroTier container
docker pull bltavares/zerotier:latest-arm32v7
docker run --device=/dev/net/tun \
--name zerotier \
--net=host \
--restart=always \
--cap-add=NET_ADMIN \
--cap-add=SYS_ADMIN \
-v /var/lib/zerotier-one:/var/lib/zerotier-one \
-d bltavares/zerotier:latest-arm32v7
# Join your network (replace with your Network ID)
docker exec zerotier zerotier-cli join your_network_id_here
BitTorrent Client Installation
Transmissoin Setup
# Install Transmission daemon
sudo apt-get install transmission-daemon -y
# Stop service for configuration
sudo systemctl stop transmission-daemon
# Configure access settings
sudo nano /etc/transmission-daemon/settings.json
Modify these settings in the configuration file:
"rpc-whitelist": "*",
"rpc-whitelist-enabled": false,
"rpc-username": "your_username",
"rpc-password": "your_encrypted_password"
# Apply Chinese language pack
wget https://github.com/ronggang/transmission-web-control/raw/master/release/install-tr-control-cn.sh
bash install-tr-control-cn.sh
# Restart service
sudo systemctl restart transmission-daemon
qBittorrent Installation (Recommended)
# Install qBittorrent-nox
sudo apt-get install qbittorrent-nox -y
# Create systemd service
sudo nano /etc/systemd/system/qbittorrent.service
Service configuration:
[Unit]
Description=qBittorrent Daemon
After=network.target
[Service]
User=root
ExecStart=/usr/bin/qbittorrent-nox
ExecStop=/usr/bin/killall -w qbittorrent-nox
[Install]
WantedBy=multi-user.target
# Enable and start service
sudo systemctl daemon-reload
sudo systemctl enable qbittorrent
sudo systemctl start qbittorrent
# Set media permissions
sudo chmod -R 755 /media
Docker qBittorrent Installation
# Deploy qBittorrent via Docker
docker run -d \
--restart=always \
--name qbittorrent-nox \
--privileged=true \
--stop-timeout 1800 \
--tmpfs /tmp \
-e QBT_EULA=accept \
-e QBT_WEBUI_PORT=8080 \
-e PGID=0 -e PUID=0 \
-p 8080:8080/tcp \
-p 6881:6881/tcp \
-p 6881:6881/udp \
-v /qbittorrent_data:/config \
-v /media:/downloads \
qbittorrentofficial/qbittorrent-nox
Klipper 3D Printer Setup
# System update
sudo apt update && sudo apt upgrade -y
# Create Klipper user
sudo useradd -m -s /bin/bash klipper
sudo passwd klipper
sudo usermod klipper -a -G sudo
# Switch to klipper user
su klipper
sudo apt install git -y
# Clone and run KIAUH installer
cd ~
git clone https://github.com/th33xitus/kiauh.git
./kiauh/kiauh.sh