uname -m          # 确认架构
ss -ltn | grep 9000   # 确认端口未占用（无输出=空闲）

x86_64

apt-get update
apt-get install -y openjdk-11-jdk-headless mariadb-server wget curl locales

Reading package lists... Done
Building dependency tree... Done
...
Setting up openjdk-11-jdk-headless:amd64 (11.0.32.1+1-1ubuntu1~22.04) ...
...
Processing triggers for man-db (2.10.2-1) ...

java -version

openjdk version "11.0.32.1" 2026-08-18
OpenJDK Runtime Environment (build 11.0.32.1+1-post-1ubuntu1-22.04-Ubuntu)

locale | head -2

LANG=
LANGUAGE=

sed -i '/en_US.UTF-8/s/^# //g' /etc/locale.gen
locale-gen
update-locale LANG=en_US.UTF-8

Generating locales (this might take a while)...
  en_US.UTF-8... done
Generation complete.

service mariadb start

 * Starting MariaDB database server mariadbd
   ...done.

mysql -e "SELECT VERSION() AS version;"

version
10.6.23-MariaDB-0ubuntu0.22.04.1

mysql -e "CREATE DATABASE facto CHARACTER SET utf8mb4;"
mysql -e "CREATE USER 'facto'@'localhost' IDENTIFIED BY 'q1w2e3r4';"
mysql -e "GRANT ALL PRIVILEGES ON facto.* TO 'facto'@'localhost';"
mysql -e "FLUSH PRIVILEGES;"

mysql -ufacto -pq1w2e3r4 facto -e "SHOW DATABASES;"

+--------------------+
| Database           |
+--------------------+
| facto              |
| information_schema |
+--------------------+

mkdir -p /opt/facto
wget https://github.com/nymanjens/facto/releases/download/v4.29/release-v4.29.tar.gz

release-v4.29.tar.gz    100% [============================================>]  80.04M  9.2MB/s  in 9.9s

2026-10-23 11:22:30 (8.1 MB/s) - 'release-v4.29.tar.gz' saved [83932089/83932089]

sha256sum release-v4.29.tar.gz

3681d703817ae2a3a80125de270e1bf73436f4474e32a3a7593a80b2e28925a7  release-v4.29.tar.gz

cd /opt/facto
tar -xzf /root/release-v4.29.tar.gz
ls -la

total 28
drwxr-xr-x 5 root root  4096 Oct 23 11:22 .
drwxr-xr-x 5 root root  4096 Oct 23 11:23 ..
drwxrwxr-x 2 1000 1000  4096 Aug  1 14:56 bin
drwxrwxr-x 2 1000 1000  4096 Aug  1 14:56 conf
drwxrwxr-x 2 1000 1000 12288 Aug  1 14:56 lib

# Play Framework
play {
  # Secret key
  http.secret.key="changeme"

  # The application languages
  i18n.langs = ["en"] # Supported: "en" and "nl"

  # Maximal attachment size
  server.websocket.frame.maxLength = 100M

  # Session configuration
  http.session.maxAge = 60d
}

# Database configuration
db.default {
  driver = com.mysql.jdbc.Driver
  url = "jdbc:mysql://localhost/facto?user=mysqluser&password=mysqlpassword"
  slick.profile = "slick.jdbc.MySQLProfile$"
}

# Application-specific configuration
app {
  accounting.configYamlFilePath = "conf/accounting-config.yml"
  accounting.attachmentsFolder = "/changeme/path/to/attachments/folder"
  setup.defaultPassword = "changeme"
}

mkdir -p /opt/facto/attachments

# Play Framework
play {
  # Secret key
  http.secret.key="facto-secret-2026-q1w2e3r4"

  # The application languages
  i18n.langs = ["en"] # Supported: "en" and "nl"

  # Maximal attachment size
  server.websocket.frame.maxLength = 100M

  # Session configuration
  http.session.maxAge = 60d
}

# Database configuration
db.default {
  driver = com.mysql.jdbc.Driver
  url = "jdbc:mysql://localhost/facto?user=facto&password=q1w2e3r4"
  slick.profile = "slick.jdbc.MySQLProfile$"
}

# Application-specific configuration
app {
  accounting.configYamlFilePath = "conf/accounting-config.yml"
  accounting.attachmentsFolder = "/opt/facto/attachments"
  setup.defaultPassword = "q1w2e3r4"
}

export LANG=en_US.UTF-8
cd /opt/facto
bin/server -DdropAndCreateNewDb

WARNING: An illegal reflective access operation has occurred
WARNING: Illegal reflective access by com.google.inject.internal.cglib.core.$ReflectUtils$1 (file:/opt/facto/lib/com.google.inject.guice-4.2.3.jar) to method java.lang.ClassLoader.defineClass(java.lang.String,byte[],int,int,java.security.ProtectionDomain)
WARNING: Please consider reporting this to the maintainers of com.google.inject.internal.cglib.core.$ReflectUtils$1
[info] p.a.d.DefaultDBApi - Database [default] initialized
[info] p.a.d.HikariCPConnectionPool - Creating Pool for datasource 'default'

  Dropping the database tables (if present) and creating new ones...
  Done. Exiting.

mysql -ufacto -pq1w2e3r4 facto -e "SHOW TABLES;"

+---------------------------+
| Tables_in_facto           |
+---------------------------+
| BALANCE_CHECKS            |
| ENTITY_MODIFICATION_ENTITY|
| EXCHANGE_RATE_MEASUREMENT |
| TRANSACTIONS              |
| TRANSACTION_GROUPS        |
| USERS                     |
+---------------------------+

bin/server -DcreateAdminUser

  Creating admin user...
      loginName: admin
      password: q1w2e3r4
  Done. Exiting.

bin/server

WARNING: All illegal access operations will be denied in a future release
[info] p.a.d.DefaultDBApi - Database [default] initialized
[info] p.a.d.HikariCPConnectionPool - Creating Pool for datasource 'default'
[info] play.api.Play - Application started (Prod) (no global state)
[info] p.c.s.AkkaHttpServer - Listening for HTTP on /0:0:0:0:0:0:0:0:9000

curl -sI http://localhost:9000/

HTTP/1.1 303 See Other
Location: /login/

curl -s -o /dev/null -w "HTTP %{http_code}\n" http://localhost:9000/login/
curl -s http://localhost:9000/externalapi/healthcheck/ -w "  [HTTP %{http_code}]\n"

HTTP 200
OK  [HTTP 200]

curl -s -i -X POST 'http://localhost:9000/login/?returnTo=%2Fapp%2F' -d 'loginName=admin&password=q1w2e3r4' | grep -E 'HTTP/|Location' | head -2

HTTP/1.1 303 See Other
Location: /app/

wget https://github.com/nymanjens/facto/releases/download/v4.29/release-v4.29.tar.gz
sha256sum release-v4.29.tar.gz

3681d703817ae2a3a80125de270e1bf73436f4474e32a3a7593a80b2e28925a7  release-v4.29.tar.gz

mkdir -p /tmp/debs && cd /tmp/debs
apt-get download openjdk-11-jre-headless

Fetched 42.6 MB in 4s (9543 kB/s)
W: Download is performed unsandboxed as root as file '/tmp/debs/openjdk-11-jre-headless_11.0.32.1+1-1ubuntu1~22.04_amd64.deb' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)

scp release-v4.29.tar.gz /tmp/debs/*.deb user@192.168.1.100:/opt/install-pkg/

cd /opt/install-pkg
dpkg -i openjdk-11-jre-headless_11.0.32.1+1-1ubuntu1~22.04_amd64.deb
apt-get install -f -y

useradd -r -d /opt/facto -s /bin/sh facto
chown -R facto:facto /opt/facto

wget https://raw.githubusercontent.com/nymanjens/facto/v4.29/unix-service.sh -O /etc/init.d/facto
chmod +x /etc/init.d/facto

### settings ##
SERVICE_ROOT=/opt/facto
USER=facto
HOME=/opt/facto

    export JAVA_OPTS="-Xms256m -Xmx256m"
    su $USER -c "cd $SERVICE_ROOT && bin/server" > /tmp/facto-logs 2>&1 &

update-rc.d facto defaults

update-rc.d: warning: start and stop actions are no longer supported; falling back to defaults

service facto start

Starting facto...

Waiting for RUNNING_PID to appear
Done. Process 6139 was started.

curl -s http://localhost:9000/externalapi/healthcheck/ -w "  [HTTP %{http_code}]\n"
jps -v | grep -v Jps

OK  [HTTP 200]
6139 ProdServerStart -Xms256m -Xmx256m -Duser.dir=/opt/facto

service facto stop

Stopping facto...

Killing process 6139 found in RUNNING_PID
Waiting for RUNNING_PID to disappear...
Done

curl -s -o /dev/null -w "after-stop: HTTP %{http_code}\n" http://localhost:9000/externalapi/healthcheck/ --max-time 3

after-stop: HTTP 000

[Unit]
Description=Family Accounting Tool (facto)
After=network.target mariadb.service
Wants=mariadb.service

[Service]
Type=simple
User=facto
Group=facto
WorkingDirectory=/opt/facto
Environment="JAVA_OPTS=-Xms256m -Xmx256m"
Environment=LANG=en_US.UTF-8
ExecStart=/opt/facto/bin/server
ExecStop=/bin/kill -15 $MAINPID
SuccessExitStatus=143
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

systemctl daemon-reload
systemctl enable facto

Created symlink /etc/systemd/system/multi-user.target.wants/facto.service → /etc/systemd/system/facto.service.

systemctl start facto
systemctl status facto --no-pager | head -8

● facto.service - Family Accounting Tool (facto)
     Loaded: loaded (/etc/systemd/system/facto.service; enabled; vendor preset: enabled)
     Active: active (running) since Fri 2026-10-23 03:31:34 UTC; 14s ago
   Main PID: 5119 (java)
      Tasks: 39 (limit: 94371)
     Memory: 266.9M

jps -v | grep -v Jps

5249 ProdServerStart -Xms256m -Xmx256m -Duser.dir=/opt/facto

systemctl is-active facto

active

mysqldump -ufacto -pq1w2e3r4 --databases facto > /root/facto-backup-$(date +%F).sql

cp -a /opt/facto/conf /root/facto-conf-backup
cp -a /opt/facto/attachments /root/facto-attachments-backup

[error] a.m.a.c.ConfigModule - Error when parsing accounting-config.yml: java.nio.charset.MalformedInputException: Input length = 1
        at java.base/java.nio.charset.CoderResult.throwException(CoderResult.java:274)

  Dropping the database tables (if present) and creating new ones...
  Done. Exiting.

curl -s http://localhost:9000/login/ | grep -oE '<input[^>]*>'

<input class="form-control" placeholder="Username" name="loginName" value="" autofocus />
<input class="form-control" placeholder="Password" name="password" type="password" value="" />

Waiting for RUNNING_PID to appear
Timed out

This account is currently not available.

usermod -s /bin/sh facto

Done. Process 5987 was started.

bin/server -DcreateAdminUser

systemctl disable --now facto 2>/dev/null || service facto stop   # 停止服务（二选一按实际托管方式）
rm -f /etc/systemd/system/facto.service /etc/init.d/facto          # 移除服务定义
systemctl daemon-reload 2>/dev/null
rm -rf /opt/facto                                                  # 移除应用本体与附件
mysql -e "DROP DATABASE IF EXISTS facto;"                          # 删除数据库
mysql -e "DROP USER IF EXISTS 'facto'@'localhost';"                # 删除数据库账号
userdel facto 2>/dev/null                                          # 删除系统账号
apt-get purge -y mariadb-server openjdk-11-jdk-headless            # 移除系统依赖（可选）
apt-get autoremove -y

ss -ltn | grep 9000 ; jps -v | grep -v Jps