sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key \
  | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_20.x nodistro main" \
  | sudo tee /etc/apt/sources.list.d/nodesource.list
sudo apt-get update
sudo apt-get install -y nodejs

$ node -v
v24.22.1

sudo corepack enable
cd /opt/handbrake-web/app
pnpm -v

$ pnpm -v
10.16.1

sudo apt-get install -y build-essential python3 pkg-config

.../node_modules/better-sqlite3 install:   CC(target) Release/obj.target/test_extension/deps/test_extension.o
.../node_modules/better-sqlite3 install:   SOLINK_MODULE(target) Release/obj.target/test_extension.node
.../node_modules/better-sqlite3 install: gyp info ok
.../node_modules/better-sqlite3 install: Done

sudo apt-get install -y handbrake-cli
HandBrakeCLI --version 2>&1 | tail -6

[21:43:44] Compile-time hardening features are enabled
Cannot load libnvidia-encode.so.1
[21:43:44] qsv: not available on this system
[21:43:44] hb_init: starting libhb thread
[21:43:44] thread 765634fb26c0 started ("libhb")
HandBrake has exited.
HandBrake 1.11.0

sudo apt-get install -y intel-media-va-driver-non-free i965-va-driver vainfo
sudo usermod -aG video handbrake
ls -l /dev/dri
vainfo

sudo apt-get install -y mesa-va-drivers vainfo
vainfo --display drm --device /dev/dri/renderD128

Capability 'vcn' support = false

$ which ffprobe
ffprobe: command not found
$ node -e "console.log(require('ffprobe-static').path)"
/opt/handbrake-web/app/node_modules/.pnpm/ffprobe-static@3.1.0/node_modules/ffprobe-static/bin/linux/x64/ffprobe

sudo mkdir -p /opt/handbrake-web
sudo chown -R "$USER":"$USER" /opt/handbrake-web
git clone --branch v0.8.1 --depth 1 \
  https://github.com/TheNickOfTime/handbrake-web.git /opt/handbrake-web/app
cd /opt/handbrake-web/app
git log -1 --oneline

cd /opt/handbrake-web/app
pnpm install

.../node_modules/better-sqlite3 install: gyp info ok
.../node_modules/better-sqlite3 install: Done

shared postinstall$ tsc -b
shared postinstall: Done
Done in 1m 33.8s using pnpm v10.16.1

cd /opt/handbrake-web/app
pnpm build:shared
pnpm build:server
pnpm build:worker
pnpm build:client

> @handbrake-web/shared@0.8.1 build
> tsc -b

> @handbrake-web/server@0.8.1 build
> node build.mjs
[server] [build] Starting server application build process...
[server] [build] Cleared existing output from the 'build' directory.
[server] [build] Bundling the server application...
  build/server.js  3.4mb ⚠️
⚡ Done in 277ms
[server] [build] Successfully bundled the server application.
[server] [build] Copying non-bundled dependencies to the build output location...

> @handbrake-web/worker@0.8.1 build
> node build.mjs
[worker] [build] Starting worker application build process...
  build/worker.js  860.2kb
⚡ Done in 86ms
[server] [build] Successfully bundled the worker application.

> @handbrake-web/client@0.8.1 build
> tsr generate && tsc -b && vite build
vite v7.3.0 building client environment for production...
✓ 334 modules transformed.
✓ built in 2.22s

▲ [WARNING] The condition "types" here will never be used as it comes after "default" [package.json]
    ../shared/package.json:33:6

ls -lh /opt/handbrake-web/app/server/build/server.js \
       /opt/handbrake-web/app/worker/build/worker.js \
       /opt/handbrake-web/app/client/build/index.html
ls /opt/handbrake-web/app/client/build/assets | wc -l

sudo mkdir -p /opt/handbrake-web/data
sudo mkdir -p /opt/handbrake-web/worker-data
sudo mkdir -p /srv/handbrake-web/video/input
sudo mkdir -p /srv/handbrake-web/video/output
sudo useradd -r -s /usr/sbin/nologin handbrake
sudo chown -R handbrake:handbrake /opt/handbrake-web /srv/handbrake-web

config:
  version: 2
paths:
  media-path: /video
  input-path: /video
  output-path: ""
presets:
  show-default-presets: true
  allow-preset-creator: false
application:
  queue-startup-behavior: 0
  update-check-interval: 12

paths:
  media-path: /srv/handbrake-web/video
  input-path: /srv/handbrake-web/video/input
  output-path: /srv/handbrake-web/video/output

dpkg -L handbrake-cli | grep preset_builtin

# 方式一：做符号链接，让默认路径成立
sudo mkdir -p /var/lib/handbrake
sudo ln -s /usr/share/handbrake/preset_builtin.json /var/lib/handbrake/preset_builtin.json

# 方式二：用环境变量指到真实路径（写进 systemd 单元）
DEFAULT_PRESETS_PATH=/usr/share/handbrake/preset_builtin.json

cd /opt/handbrake-web/app/server
sudo -u handbrake env \
  DATA_PATH=/opt/handbrake-web/data \
  VIDEO_PATH=/srv/handbrake-web/video \
  DEFAULT_PRESETS_PATH=/usr/share/handbrake/preset_builtin.json \
  NODE_ENV=production \
  SERVER_URL=192.168.1.20 \
  node build/server.js

21:35:45 [server] [permissions] Checking necessary directory permissions...
21:35:45 [server] [permissions] Checking permissions for the path '/opt/data/quzuo/.trae/tmp/handbrake-web/bare/data'.
21:35:45 [server] [permissions] Finished checking permissions across 2 paths with 0 errors and 0 warnings.
21:35:45 [server] [config] [migration] The config file's schema (v2) is up to date.
21:35:45 [server] [config] The config file at '/opt/data/quzuo/.trae/tmp/handbrake-web/bare/data/config.yaml' has been loaded.
21:35:45 [server] [presets] Default presets have been loaded from '/opt/data/quzuo/.trae/tmp/handbrake-web/preset_builtin.json'.
21:35:45 [server] [presets] 2 presets have been loaded from '/opt/data/quzuo/.trae/tmp/handbrake-web/bare/data/presets'.
21:35:45 [server] [database] [migration] Running 0 migrations...
21:35:45 [server] [database] [migration] All migrations have completed.
21:35:45 [server] [database] The database is ready!
21:35:45 [server] [queue] Existing queue status 'Stopped' retreived from the database.
21:35:45 [server] Available at 'http://localhost:9999'.
21:35:45 [server] [version] Checking if there is an application update...
21:35:46 [server] [version] The application is up to date.

sudo mkdir -p /handbrake-web
sudo ln -s /opt/handbrake-web/app/client/build /handbrake-web/client
ls -l /handbrake-web/client/index.html

NotFoundError: Not Found
    at createHttpError (/opt/handbrake-web/app/server/build/server.js:39402:16)
    at SendStream.error2 [as error] (.../server.js:39040:35)
    at SendStream.pipe (.../server.js:39196:18)
    at sendfile (.../server.js:39913:12)
    at ServerResponse.sendFile (.../server.js:39657:7)
    at .../server.js:61779:9

$ curl -sSI http://127.0.0.1:8088/
HTTP/1.0 200 OK
Server: SimpleHTTP/0.6 Python/3.14.4
Date: Tue, 27 Oct 2026 13:45:23 GMT
Content-type: text/html
Content-Length: 400
Last-Modified: Tue, 27 Oct 2026 13:25:37 GMT

$ curl -s http://127.0.0.1:8088/ | head -10
<!DOCTYPE html>
<html lang="en" data-theme="dark">
	<head>
		<meta charset="UTF-8" />
		<meta name="viewport" content="width=device-width, initial-scale=1.0" />
		<title>HandBrake Web</title>
		<script type="module" crossorigin src="/assets/index-KDtZ52pI.js"></script>
		<link rel="stylesheet" crossorigin href="/assets/index-DzUjQMTP.css">
	</head>
	<body>
		<div id="root"></div>
	</body>
</html>

cd /opt/handbrake-web/app/worker
sudo -u handbrake env \
  WORKER_ID=worker-01 \
  SERVER_URL=http://192.168.1.20 \
  SERVER_PORT=9999 \
  DATA_PATH=/opt/handbrake-web/worker-data \
  VIDEO_PATH=/srv/handbrake-web/video \
  node build/worker.js

21:36:04 [worker] The data directory '/opt/data/quzuo/.trae/tmp/handbrake-web/bare/worker-data' is not a child of '/tmp' and already exists.
21:36:04 [worker] [permissions] Checking necessary directory permissions...
21:36:04 [worker] [permissions] Finished checking permissions across 2 paths with 0 errors and 0 warnings.
21:36:04 [worker-01] [properties] HandBrake Web Application Version = 0.8.1
21:36:04 [worker-01] [properties] HandBrake Version = 1.11.0
21:36:04 [worker-01] [properties] Capability 'cpu' support = true
21:36:04 [worker-01] [properties] Capability 'qsv' support = false
21:36:04 [worker-01] [properties] Capability 'nvenc' support = false
21:36:04 [worker-01] [properties] Capability 'vcn' support = false
21:36:04 [worker-01] The worker process has started.
21:36:04 [worker-01] [socket] Connected to the server 'http://127.0.0.1:9999/worker' with id 'UdrZ-E5H-b07ha-pAAAB'.
21:36:04 [worker-01] [socket] The server is requesting this worker's properties...
21:36:04 [worker-01] [socket] The server is requesting the status of this worker...
21:36:04 [worker-01] [socket] This worker is currently not busy with a job - reporting to the server.

21:36:04 [server] [socket] Worker 'worker-01' has connected with ID 'UdrZ-E5H-b07ha-pAAAB'.
21:36:04 [server] [socket] Getting worker 'worker-01' properties...
21:36:04 [server] [socket] Worker properties = {
  "version": { "handbrake": "1.11.0", "application": "0.8.1" },
  "capabilities": { "cpu": true, "qsv": false, "nvenc": false, "vcn": false }
}
21:36:04 [server] [socket] Checking worker 'worker-01' for an existing job in progress...
21:36:04 [server] [socket] Worker 'worker-01' is not busy with an existing job.

# /etc/systemd/system/handbrake-server.service
[Unit]
Description=HandBrake Web 0.8.1 server
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=handbrake
Group=handbrake
WorkingDirectory=/opt/handbrake-web/app/server
Environment=DATA_PATH=/opt/handbrake-web/data
Environment=VIDEO_PATH=/srv/handbrake-web/video
Environment=DEFAULT_PRESETS_PATH=/usr/share/handbrake/preset_builtin.json
Environment=NODE_ENV=production
Environment=SERVER_URL=192.168.1.20
ExecStart=/usr/bin/node build/server.js
Restart=always
RestartSec=5
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target

# /etc/systemd/system/handbrake-worker.service
[Unit]
Description=HandBrake Web 0.8.1 worker
After=network-online.target handbrake-server.service
Wants=network-online.target

[Service]
Type=simple
User=handbrake
Group=handbrake
SupplementaryGroups=video
WorkingDirectory=/opt/handbrake-web/app/worker
Environment=WORKER_ID=worker-01
Environment=SERVER_URL=http://192.168.1.20
Environment=SERVER_PORT=9999
Environment=DATA_PATH=/opt/handbrake-web/worker-data
Environment=VIDEO_PATH=/srv/handbrake-web/video
ExecStart=/usr/bin/node build/worker.js
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now handbrake-server.service
sudo systemctl enable --now handbrake-worker.service
systemctl status handbrake-server.service --no-pager
systemctl status handbrake-worker.service --no-pager

# /etc/nginx/sites-available/handbrake-web
server {
    listen 8128;
    server_name handbrake.example.com;

    # 前端静态文件（构建产物）
    root /opt/handbrake-web/app/client/build;
    index index.html;

    # 基础认证：0.8.1 无登录体系，必须在外层加
    auth_basic "HandBrake Web";
    auth_basic_user_file /etc/nginx/.htpasswd-handbrake;

    location / {
        try_files $uri $uri/ /index.html;
    }

    # Socket.IO 长连接（/client 与 /worker 两个命名空间共用）
    location /socket.io/ {
        proxy_pass http://127.0.0.1:9999;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_read_timeout 3600s;
        proxy_send_timeout 3600s;
    }

    # 任务日志下载
    location /logs/ {
        proxy_pass http://127.0.0.1:9999;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

sudo apt-get install -y apache2-utils
sudo htpasswd -cb /etc/nginx/.htpasswd-handbrake root q1w2e3r4
sudo ln -s /etc/nginx/sites-available/handbrake-web /etc/nginx/sites-enabled/handbrake-web
sudo nginx -t
sudo systemctl reload nginx

ffmpeg -f lavfi -i testsrc=size=640x360:rate=24 -f lavfi -i sine=frequency=440 \
  -t 60 -c:v libx264 -c:a aac /srv/handbrake-web/video/input/sample.mp4

const { io } = require('socket.io-client');
const s = io('http://127.0.0.1:9999/client');
const input = '/srv/handbrake-web/video/input/sample.mp4';
const output = '/srv/handbrake-web/video/output/sample-out.mkv';
let started = false;

s.on('connect', () => console.log('client connected', s.id));
s.on('queue-update', (q) => {
  console.log('queue-update:', JSON.stringify(q.map(j => ({
    id: j.job_id, stage: j.transcode_stage, pct: j.transcode_percentage,
    fps: j.transcode_fps_average, worker: j.worker_id
  }))));
  if (q.length && !started) { started = true; s.emit('start-queue'); }
  if (q.length && q[0].transcode_stage === 3) { process.exit(0); }
});

setTimeout(() => {
  s.emit('add-job', {
    input_path: input,
    output_path: output,
    preset_category: 'Default: General',
    preset_id: 'Very Fast 720p30'
  }, () => console.log('add-job ack'));
}, 1500);

21:37:09 [server] [socket] Client '_mpqHiYEAhkURdb9AAAF' has connected.
21:37:10 [server] [socket] Client '_mpqHiYEAhkURdb9AAAF' has requested to add a job for '.../video/input/sample.mp4' to the queue.
21:37:10 [server] [database] Inserted a new job with id '1' into the database at order index '1'.
21:37:10 [server] [queue] There are 1 available jobs and 1 eligible for 'worker-01'.
21:37:10 [server] [queue] Assigning worker with ID 'worker-01' to job with id '1'.
21:37:10 [server] [database] Sucessfully updated the status of 'queue' to 'Active'.
21:37:10 [server] [database] Status for job with id '1' has changed from 'Waiting' to 'Scanning'.
21:37:10 [server] [queue] Worker 'worker-01' has started work on job '1'.
21:37:11 [server] [database] Status for job with id '1' has changed from 'Scanning' to 'Transcoding'.
21:37:15 [server] [database] Status for job with id '1' has changed from 'Transcoding' to 'Finished'.
21:37:15 [server] [queue] There are no active workers, setting queue to 'Idle'.
21:37:15 [server] [log] Log file from worker 'worker-01' has been written to '.../data/log/worker-01-job-1.log'.

21:37:10 [worker-01] [socket] Request to transcode queue entry '1'.
21:37:10 [worker-01] [worker] Sucessfully wrote preset to file.
21:37:11 [worker-01] [transcode] Opening .../video/input/sample.mp4...
21:37:11 [worker-01] [transcode] + Using preset: Very Fast 720p30
21:37:11 [worker-01] [transcode] [processing] 9.03 %
21:37:12 [worker-01] [transcode] [processing] 45.07 %
21:37:15 [worker-01] [transcode] [processing] 99.93 %
21:37:15 [worker-01] [transcode] Encode done!
21:37:15 [worker-01] [transcode] Renaming the file 'sample-out.transcoding.mkv' to 'sample-out.mkv'.
21:37:15 [worker-01] [transcode] Removed the preset file 'preset.json'.
21:37:15 [worker-01] [transcode] [finished] 100.00%
21:37:15 [worker-01] [log] Sending the log 'worker-01-job-1.log' to the server.

ls -lh /srv/handbrake-web/video/output/sample-out.mkv
ls -lh /opt/handbrake-web/data/
ls -lh /opt/handbrake-web/data/log/

21:45:24 [undefined] No 'WORKER_ID' envrionment variable is set - this worker will not be set up.
$ echo $?
0

HandBrakeCLI: /root/.trae-cn-server/bin/.../libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /usr/lib/x86_64-linux-gnu/libjxl.so.0.11)
HandBrakeCLI: /root/.trae-cn-server/bin/.../libgcc_s.so.1: version `GCC_13.0.0' not found (required by /usr/lib/x86_64-linux-gnu/libhwy.so.1)
[capabilities] [error] Could not get the worker's info.

#!/bin/sh
export LD_LIBRARY_PATH=
exec /usr/bin/HandBrakeCLI "$@"