From 8ec7495cab3c272a2599aa1087182968d4d11c8a Mon Sep 17 00:00:00 2001 From: xiaomage Date: Sun, 2 Aug 2026 09:44:01 +0800 Subject: [PATCH 1/2] docs: align RustFS environment examples --- content/de/installation/container/docker.md | 1 + content/de/installation/container/index.mdx | 3 +++ content/de/installation/container/podman.md | 1 + content/de/installation/linux/multiple-node-multiple-disk.md | 5 +++-- content/de/installation/linux/single-node-multiple-disk.md | 5 +++-- content/de/installation/linux/single-node-single-disk.md | 5 +++-- content/de/operations/upgrade/container/index.md | 2 ++ content/en/installation/container/docker.md | 1 + content/en/installation/container/index.mdx | 3 +++ content/en/installation/container/podman.md | 1 + content/en/installation/linux/multiple-node-multiple-disk.md | 5 +++-- content/en/installation/linux/single-node-multiple-disk.md | 5 +++-- content/en/installation/linux/single-node-single-disk.md | 5 +++-- content/en/operations/upgrade/container/index.md | 2 ++ content/fr/installation/container/docker.md | 1 + content/fr/installation/container/index.mdx | 3 +++ content/fr/installation/container/podman.md | 1 + content/fr/installation/linux/multiple-node-multiple-disk.md | 5 +++-- content/fr/installation/linux/single-node-multiple-disk.md | 5 +++-- content/fr/installation/linux/single-node-single-disk.md | 5 +++-- content/fr/operations/upgrade/container/index.md | 2 ++ content/ja/installation/container/docker.md | 1 + content/ja/installation/container/index.mdx | 3 +++ content/ja/installation/container/podman.md | 1 + content/ja/installation/linux/multiple-node-multiple-disk.md | 5 +++-- content/ja/installation/linux/single-node-multiple-disk.md | 5 +++-- content/ja/installation/linux/single-node-single-disk.md | 5 +++-- content/ja/operations/upgrade/container/index.md | 2 ++ content/zh/installation/container/docker.md | 1 + content/zh/installation/container/index.mdx | 3 +++ content/zh/installation/container/podman.md | 1 + content/zh/installation/linux/multiple-node-multiple-disk.md | 5 +++-- content/zh/installation/linux/single-node-multiple-disk.md | 5 +++-- content/zh/installation/linux/single-node-single-disk.md | 5 +++-- content/zh/operations/upgrade/container/index.md | 2 ++ 35 files changed, 80 insertions(+), 30 deletions(-) diff --git a/content/de/installation/container/docker.md b/content/de/installation/container/docker.md index 26124785..504937f5 100644 --- a/content/de/installation/container/docker.md +++ b/content/de/installation/container/docker.md @@ -33,6 +33,7 @@ docker run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs:latest \ /data ``` diff --git a/content/de/installation/container/index.mdx b/content/de/installation/container/index.mdx index b7528a27..3d86faa3 100644 --- a/content/de/installation/container/index.mdx +++ b/content/de/installation/container/index.mdx @@ -78,6 +78,7 @@ docker run -d \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_ADDRESS=:9000 \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs:latest \ /data ``` @@ -122,6 +123,7 @@ docker run -d \ -p 9001:9001 \ -v /mnt/data:/data \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs:latest \ --console-enable \ /data @@ -270,6 +272,7 @@ docker run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" \ rustfs/rustfs:latest ``` diff --git a/content/de/installation/container/podman.md b/content/de/installation/container/podman.md index fdcb320a..db508c6a 100644 --- a/content/de/installation/container/podman.md +++ b/content/de/installation/container/podman.md @@ -32,6 +32,7 @@ podman run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ docker.io/rustfs/rustfs:latest \ /data ``` diff --git a/content/de/installation/linux/multiple-node-multiple-disk.md b/content/de/installation/linux/multiple-node-multiple-disk.md index eaf7bfb3..a88d4253 100644 --- a/content/de/installation/linux/multiple-node-multiple-disk.md +++ b/content/de/installation/linux/multiple-node-multiple-disk.md @@ -68,8 +68,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` :::note diff --git a/content/de/installation/linux/single-node-multiple-disk.md b/content/de/installation/linux/single-node-multiple-disk.md index 95dd8f00..df6f2135 100644 --- a/content/de/installation/linux/single-node-multiple-disk.md +++ b/content/de/installation/linux/single-node-multiple-disk.md @@ -43,8 +43,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. Create the storage and log directories: diff --git a/content/de/installation/linux/single-node-single-disk.md b/content/de/installation/linux/single-node-single-disk.md index cf912d2f..8e83ffce 100644 --- a/content/de/installation/linux/single-node-single-disk.md +++ b/content/de/installation/linux/single-node-single-disk.md @@ -42,8 +42,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs0" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. Create the storage and log directories: diff --git a/content/de/operations/upgrade/container/index.md b/content/de/operations/upgrade/container/index.md index 071146bc..093d1e9c 100644 --- a/content/de/operations/upgrade/container/index.md +++ b/content/de/operations/upgrade/container/index.md @@ -51,6 +51,7 @@ docker run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs: \ /data ``` @@ -85,6 +86,7 @@ podman run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ docker.io/rustfs/rustfs: \ /data ``` diff --git a/content/en/installation/container/docker.md b/content/en/installation/container/docker.md index 26124785..504937f5 100644 --- a/content/en/installation/container/docker.md +++ b/content/en/installation/container/docker.md @@ -33,6 +33,7 @@ docker run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs:latest \ /data ``` diff --git a/content/en/installation/container/index.mdx b/content/en/installation/container/index.mdx index b7528a27..3d86faa3 100644 --- a/content/en/installation/container/index.mdx +++ b/content/en/installation/container/index.mdx @@ -78,6 +78,7 @@ docker run -d \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_ADDRESS=:9000 \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs:latest \ /data ``` @@ -122,6 +123,7 @@ docker run -d \ -p 9001:9001 \ -v /mnt/data:/data \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs:latest \ --console-enable \ /data @@ -270,6 +272,7 @@ docker run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" \ rustfs/rustfs:latest ``` diff --git a/content/en/installation/container/podman.md b/content/en/installation/container/podman.md index fdcb320a..db508c6a 100644 --- a/content/en/installation/container/podman.md +++ b/content/en/installation/container/podman.md @@ -32,6 +32,7 @@ podman run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ docker.io/rustfs/rustfs:latest \ /data ``` diff --git a/content/en/installation/linux/multiple-node-multiple-disk.md b/content/en/installation/linux/multiple-node-multiple-disk.md index eaf7bfb3..a88d4253 100644 --- a/content/en/installation/linux/multiple-node-multiple-disk.md +++ b/content/en/installation/linux/multiple-node-multiple-disk.md @@ -68,8 +68,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` :::note diff --git a/content/en/installation/linux/single-node-multiple-disk.md b/content/en/installation/linux/single-node-multiple-disk.md index 95dd8f00..df6f2135 100644 --- a/content/en/installation/linux/single-node-multiple-disk.md +++ b/content/en/installation/linux/single-node-multiple-disk.md @@ -43,8 +43,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. Create the storage and log directories: diff --git a/content/en/installation/linux/single-node-single-disk.md b/content/en/installation/linux/single-node-single-disk.md index cf912d2f..8e83ffce 100644 --- a/content/en/installation/linux/single-node-single-disk.md +++ b/content/en/installation/linux/single-node-single-disk.md @@ -42,8 +42,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs0" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. Create the storage and log directories: diff --git a/content/en/operations/upgrade/container/index.md b/content/en/operations/upgrade/container/index.md index 071146bc..093d1e9c 100644 --- a/content/en/operations/upgrade/container/index.md +++ b/content/en/operations/upgrade/container/index.md @@ -51,6 +51,7 @@ docker run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs: \ /data ``` @@ -85,6 +86,7 @@ podman run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ docker.io/rustfs/rustfs: \ /data ``` diff --git a/content/fr/installation/container/docker.md b/content/fr/installation/container/docker.md index 26124785..504937f5 100644 --- a/content/fr/installation/container/docker.md +++ b/content/fr/installation/container/docker.md @@ -33,6 +33,7 @@ docker run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs:latest \ /data ``` diff --git a/content/fr/installation/container/index.mdx b/content/fr/installation/container/index.mdx index b7528a27..3d86faa3 100644 --- a/content/fr/installation/container/index.mdx +++ b/content/fr/installation/container/index.mdx @@ -78,6 +78,7 @@ docker run -d \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_ADDRESS=:9000 \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs:latest \ /data ``` @@ -122,6 +123,7 @@ docker run -d \ -p 9001:9001 \ -v /mnt/data:/data \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs:latest \ --console-enable \ /data @@ -270,6 +272,7 @@ docker run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" \ rustfs/rustfs:latest ``` diff --git a/content/fr/installation/container/podman.md b/content/fr/installation/container/podman.md index fdcb320a..db508c6a 100644 --- a/content/fr/installation/container/podman.md +++ b/content/fr/installation/container/podman.md @@ -32,6 +32,7 @@ podman run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ docker.io/rustfs/rustfs:latest \ /data ``` diff --git a/content/fr/installation/linux/multiple-node-multiple-disk.md b/content/fr/installation/linux/multiple-node-multiple-disk.md index eaf7bfb3..a88d4253 100644 --- a/content/fr/installation/linux/multiple-node-multiple-disk.md +++ b/content/fr/installation/linux/multiple-node-multiple-disk.md @@ -68,8 +68,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` :::note diff --git a/content/fr/installation/linux/single-node-multiple-disk.md b/content/fr/installation/linux/single-node-multiple-disk.md index 95dd8f00..df6f2135 100644 --- a/content/fr/installation/linux/single-node-multiple-disk.md +++ b/content/fr/installation/linux/single-node-multiple-disk.md @@ -43,8 +43,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. Create the storage and log directories: diff --git a/content/fr/installation/linux/single-node-single-disk.md b/content/fr/installation/linux/single-node-single-disk.md index cf912d2f..8e83ffce 100644 --- a/content/fr/installation/linux/single-node-single-disk.md +++ b/content/fr/installation/linux/single-node-single-disk.md @@ -42,8 +42,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs0" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. Create the storage and log directories: diff --git a/content/fr/operations/upgrade/container/index.md b/content/fr/operations/upgrade/container/index.md index 071146bc..093d1e9c 100644 --- a/content/fr/operations/upgrade/container/index.md +++ b/content/fr/operations/upgrade/container/index.md @@ -51,6 +51,7 @@ docker run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs: \ /data ``` @@ -85,6 +86,7 @@ podman run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ docker.io/rustfs/rustfs: \ /data ``` diff --git a/content/ja/installation/container/docker.md b/content/ja/installation/container/docker.md index 26124785..504937f5 100644 --- a/content/ja/installation/container/docker.md +++ b/content/ja/installation/container/docker.md @@ -33,6 +33,7 @@ docker run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs:latest \ /data ``` diff --git a/content/ja/installation/container/index.mdx b/content/ja/installation/container/index.mdx index b7528a27..3d86faa3 100644 --- a/content/ja/installation/container/index.mdx +++ b/content/ja/installation/container/index.mdx @@ -78,6 +78,7 @@ docker run -d \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_ADDRESS=:9000 \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs:latest \ /data ``` @@ -122,6 +123,7 @@ docker run -d \ -p 9001:9001 \ -v /mnt/data:/data \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs:latest \ --console-enable \ /data @@ -270,6 +272,7 @@ docker run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" \ rustfs/rustfs:latest ``` diff --git a/content/ja/installation/container/podman.md b/content/ja/installation/container/podman.md index fdcb320a..db508c6a 100644 --- a/content/ja/installation/container/podman.md +++ b/content/ja/installation/container/podman.md @@ -32,6 +32,7 @@ podman run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ docker.io/rustfs/rustfs:latest \ /data ``` diff --git a/content/ja/installation/linux/multiple-node-multiple-disk.md b/content/ja/installation/linux/multiple-node-multiple-disk.md index eaf7bfb3..a88d4253 100644 --- a/content/ja/installation/linux/multiple-node-multiple-disk.md +++ b/content/ja/installation/linux/multiple-node-multiple-disk.md @@ -68,8 +68,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` :::note diff --git a/content/ja/installation/linux/single-node-multiple-disk.md b/content/ja/installation/linux/single-node-multiple-disk.md index 95dd8f00..df6f2135 100644 --- a/content/ja/installation/linux/single-node-multiple-disk.md +++ b/content/ja/installation/linux/single-node-multiple-disk.md @@ -43,8 +43,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. Create the storage and log directories: diff --git a/content/ja/installation/linux/single-node-single-disk.md b/content/ja/installation/linux/single-node-single-disk.md index cf912d2f..8e83ffce 100644 --- a/content/ja/installation/linux/single-node-single-disk.md +++ b/content/ja/installation/linux/single-node-single-disk.md @@ -42,8 +42,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs0" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. Create the storage and log directories: diff --git a/content/ja/operations/upgrade/container/index.md b/content/ja/operations/upgrade/container/index.md index 071146bc..093d1e9c 100644 --- a/content/ja/operations/upgrade/container/index.md +++ b/content/ja/operations/upgrade/container/index.md @@ -51,6 +51,7 @@ docker run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs: \ /data ``` @@ -85,6 +86,7 @@ podman run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ docker.io/rustfs/rustfs: \ /data ``` diff --git a/content/zh/installation/container/docker.md b/content/zh/installation/container/docker.md index be88b517..4c682ea0 100644 --- a/content/zh/installation/container/docker.md +++ b/content/zh/installation/container/docker.md @@ -33,6 +33,7 @@ docker run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs:latest \ /data ``` diff --git a/content/zh/installation/container/index.mdx b/content/zh/installation/container/index.mdx index 93e34b83..44bfc674 100644 --- a/content/zh/installation/container/index.mdx +++ b/content/zh/installation/container/index.mdx @@ -78,6 +78,7 @@ docker run -d \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_ADDRESS=:9000 \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs:latest \ /data ``` @@ -122,6 +123,7 @@ docker run -d \ -p 9001:9001 \ -v /mnt/data:/data \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs:latest \ --console-enable \ /data @@ -270,6 +272,7 @@ docker run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" \ rustfs/rustfs:latest ``` diff --git a/content/zh/installation/container/podman.md b/content/zh/installation/container/podman.md index 6d221434..532f6870 100644 --- a/content/zh/installation/container/podman.md +++ b/content/zh/installation/container/podman.md @@ -32,6 +32,7 @@ podman run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ docker.io/rustfs/rustfs:latest \ /data ``` diff --git a/content/zh/installation/linux/multiple-node-multiple-disk.md b/content/zh/installation/linux/multiple-node-multiple-disk.md index ec2da226..3bbde557 100644 --- a/content/zh/installation/linux/multiple-node-multiple-disk.md +++ b/content/zh/installation/linux/multiple-node-multiple-disk.md @@ -68,8 +68,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` :::note diff --git a/content/zh/installation/linux/single-node-multiple-disk.md b/content/zh/installation/linux/single-node-multiple-disk.md index 98094044..e9671378 100644 --- a/content/zh/installation/linux/single-node-multiple-disk.md +++ b/content/zh/installation/linux/single-node-multiple-disk.md @@ -43,8 +43,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. 创建存储和日志目录： diff --git a/content/zh/installation/linux/single-node-single-disk.md b/content/zh/installation/linux/single-node-single-disk.md index a7e22f7e..29e6b2b9 100644 --- a/content/zh/installation/linux/single-node-single-disk.md +++ b/content/zh/installation/linux/single-node-single-disk.md @@ -42,8 +42,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs0" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. 创建存储和日志目录： diff --git a/content/zh/operations/upgrade/container/index.md b/content/zh/operations/upgrade/container/index.md index 59a3bf4f..c26059e8 100644 --- a/content/zh/operations/upgrade/container/index.md +++ b/content/zh/operations/upgrade/container/index.md @@ -51,6 +51,7 @@ docker run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ rustfs/rustfs: \ /data ``` @@ -85,6 +86,7 @@ podman run -d \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ docker.io/rustfs/rustfs: \ /data ``` From 273b521b1afcfb0efd0ebda86ed337eb032d68cd Mon Sep 17 00:00:00 2001 From: xiaomage Date: Sun, 2 Aug 2026 09:57:24 +0800 Subject: [PATCH 2/2] docs: keep RustFS runtime variables together --- content/de/administration/console/index.md | 5 +++- .../developer/integration/big-data/iceberg.md | 6 +++-- .../developer/integration/big-data/milvus.md | 6 +++-- .../integration/reverse-proxy/caddy.md | 6 +++-- .../integration/reverse-proxy/haproxy.md | 6 +++-- .../integration/reverse-proxy/nginx.md | 6 +++-- .../integration/reverse-proxy/traefik.md | 6 +++-- content/de/installation/container/docker.md | 5 +++- content/de/installation/container/index.mdx | 26 ++++++++++++++----- content/de/installation/container/podman.md | 5 +++- .../linux/multiple-node-multiple-disk.md | 6 ++--- .../linux/prerequisites-and-service.md | 4 +-- .../linux/single-node-multiple-disk.md | 6 ++--- .../linux/single-node-single-disk.md | 6 ++--- content/de/operations/observability.md | 9 ++++--- .../de/operations/upgrade/container/index.md | 10 +++++-- content/de/troubleshooting/driver.md | 2 +- content/en/administration/console/index.md | 5 +++- .../developer/integration/big-data/iceberg.md | 6 +++-- .../developer/integration/big-data/milvus.md | 6 +++-- .../integration/reverse-proxy/caddy.md | 6 +++-- .../integration/reverse-proxy/haproxy.md | 6 +++-- .../integration/reverse-proxy/nginx.md | 6 +++-- .../integration/reverse-proxy/traefik.md | 6 +++-- content/en/installation/container/docker.md | 5 +++- content/en/installation/container/index.mdx | 26 ++++++++++++++----- content/en/installation/container/podman.md | 5 +++- .../linux/multiple-node-multiple-disk.md | 6 ++--- .../linux/prerequisites-and-service.md | 4 +-- .../linux/single-node-multiple-disk.md | 6 ++--- .../linux/single-node-single-disk.md | 6 ++--- content/en/operations/observability.md | 9 ++++--- .../en/operations/upgrade/container/index.md | 10 +++++-- content/en/troubleshooting/driver.md | 2 +- content/fr/administration/console/index.md | 5 +++- .../developer/integration/big-data/iceberg.md | 6 +++-- .../developer/integration/big-data/milvus.md | 6 +++-- .../integration/reverse-proxy/caddy.md | 6 +++-- .../integration/reverse-proxy/haproxy.md | 6 +++-- .../integration/reverse-proxy/nginx.md | 6 +++-- .../integration/reverse-proxy/traefik.md | 6 +++-- content/fr/installation/container/docker.md | 5 +++- content/fr/installation/container/index.mdx | 26 ++++++++++++++----- content/fr/installation/container/podman.md | 5 +++- .../linux/multiple-node-multiple-disk.md | 6 ++--- .../linux/prerequisites-and-service.md | 4 +-- .../linux/single-node-multiple-disk.md | 6 ++--- .../linux/single-node-single-disk.md | 6 ++--- content/fr/operations/observability.md | 9 ++++--- .../fr/operations/upgrade/container/index.md | 10 +++++-- content/fr/troubleshooting/driver.md | 2 +- content/ja/administration/console/index.md | 5 +++- .../developer/integration/big-data/iceberg.md | 6 +++-- .../developer/integration/big-data/milvus.md | 6 +++-- .../integration/reverse-proxy/caddy.md | 6 +++-- .../integration/reverse-proxy/haproxy.md | 6 +++-- .../integration/reverse-proxy/nginx.md | 6 +++-- .../integration/reverse-proxy/traefik.md | 6 +++-- content/ja/installation/container/docker.md | 5 +++- content/ja/installation/container/index.mdx | 26 ++++++++++++++----- content/ja/installation/container/podman.md | 5 +++- .../linux/multiple-node-multiple-disk.md | 6 ++--- .../linux/prerequisites-and-service.md | 4 +-- .../linux/single-node-multiple-disk.md | 6 ++--- .../linux/single-node-single-disk.md | 6 ++--- content/ja/operations/observability.md | 9 ++++--- .../ja/operations/upgrade/container/index.md | 10 +++++-- content/ja/troubleshooting/driver.md | 2 +- content/zh/administration/console/index.md | 5 +++- .../developer/integration/big-data/iceberg.md | 6 +++-- .../developer/integration/big-data/milvus.md | 6 +++-- .../integration/reverse-proxy/caddy.md | 6 +++-- .../integration/reverse-proxy/haproxy.md | 6 +++-- .../integration/reverse-proxy/nginx.md | 6 +++-- .../integration/reverse-proxy/traefik.md | 6 +++-- content/zh/installation/container/docker.md | 5 +++- content/zh/installation/container/index.mdx | 26 ++++++++++++++----- content/zh/installation/container/podman.md | 5 +++- .../linux/multiple-node-multiple-disk.md | 6 ++--- .../linux/prerequisites-and-service.md | 4 +-- .../linux/single-node-multiple-disk.md | 6 ++--- .../linux/single-node-single-disk.md | 6 ++--- content/zh/operations/observability.md | 9 ++++--- .../zh/operations/upgrade/container/index.md | 10 +++++-- content/zh/troubleshooting/driver.md | 2 +- 85 files changed, 405 insertions(+), 195 deletions(-) diff --git a/content/de/administration/console/index.md b/content/de/administration/console/index.md index 489ef506..e8af749f 100644 --- a/content/de/administration/console/index.md +++ b/content/de/administration/console/index.md @@ -10,8 +10,11 @@ The **RustFS Console** is the web administration interface for RustFS. Use this The Console is enabled by default and listens on port `9001`, separately from the S3 API on port `9000`. You can set the behavior explicitly with the following environment variables: ```ini title="/etc/default/rustfs" -RUSTFS_CONSOLE_ENABLE=true +RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` Restart RustFS after changing these values. Set `RUSTFS_CONSOLE_ENABLE=false` when the Console must not run. diff --git a/content/de/developer/integration/big-data/iceberg.md b/content/de/developer/integration/big-data/iceberg.md index 568a3699..9511170c 100644 --- a/content/de/developer/integration/big-data/iceberg.md +++ b/content/de/developer/integration/big-data/iceberg.md @@ -70,9 +70,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/de/developer/integration/big-data/milvus.md b/content/de/developer/integration/big-data/milvus.md index 869be2d3..2b17701b 100644 --- a/content/de/developer/integration/big-data/milvus.md +++ b/content/de/developer/integration/big-data/milvus.md @@ -96,9 +96,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/de/developer/integration/reverse-proxy/caddy.md b/content/de/developer/integration/reverse-proxy/caddy.md index 57c1a55b..cd1c2384 100644 --- a/content/de/developer/integration/reverse-proxy/caddy.md +++ b/content/de/developer/integration/reverse-proxy/caddy.md @@ -109,8 +109,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/de/developer/integration/reverse-proxy/haproxy.md b/content/de/developer/integration/reverse-proxy/haproxy.md index faac09ef..265b88c6 100644 --- a/content/de/developer/integration/reverse-proxy/haproxy.md +++ b/content/de/developer/integration/reverse-proxy/haproxy.md @@ -128,8 +128,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/de/developer/integration/reverse-proxy/nginx.md b/content/de/developer/integration/reverse-proxy/nginx.md index 12eb5230..b7d025c3 100644 --- a/content/de/developer/integration/reverse-proxy/nginx.md +++ b/content/de/developer/integration/reverse-proxy/nginx.md @@ -167,8 +167,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/de/developer/integration/reverse-proxy/traefik.md b/content/de/developer/integration/reverse-proxy/traefik.md index 7e319593..a40c7f42 100644 --- a/content/de/developer/integration/reverse-proxy/traefik.md +++ b/content/de/developer/integration/reverse-proxy/traefik.md @@ -83,8 +83,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/de/installation/container/docker.md b/content/de/installation/container/docker.md index 504937f5..8469df29 100644 --- a/content/de/installation/container/docker.md +++ b/content/de/installation/container/docker.md @@ -32,8 +32,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` diff --git a/content/de/installation/container/index.mdx b/content/de/installation/container/index.mdx index 3d86faa3..27ed2b35 100644 --- a/content/de/installation/container/index.mdx +++ b/content/de/installation/container/index.mdx @@ -76,9 +76,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_ADDRESS=:9000 \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` @@ -122,8 +124,11 @@ docker run -d \ -p 9000:9000 \ -p 9001:9001 \ -v /mnt/data:/data \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ --console-enable \ /data @@ -175,7 +180,7 @@ Running the command under root directory, docker compose --profile observability up -d ``` -Providing the necessary permissions. An initialization container is necessary to grant the correct access rights to rustfs using the `depends_on` keyword. In the example below the `rustfs_perms` service is added to the `docker-compose.yml` to handle this. To ensure logs are persisted and accessible, we map the host log directory to the container's `/logs` path +Providing the necessary permissions. An initialization container is necessary to grant the correct access rights to rustfs using the `depends_on` keyword. In the example below the `rustfs_perms` service is added to the `docker-compose.yml` to handle this. To ensure logs are persisted and accessible, we map the host log directory to the container's `/var/log/rustfs/` path ```yaml title="docker-compose.yml" services: @@ -194,9 +199,13 @@ Providing the necessary permissions. An initialization container is necessary to condition: service_completed_successfully volumes: - /path/to_host_directory/volumes/data:/data - - /path/to_host_directory/volumes/logs:/logs + - /path/to_host_directory/volumes/logs:/var/log/rustfs/ environment: - - RUSTFS_OBS_LOG_DIRECTORY=/logs + - RUSTFS_ADDRESS=":9000" + - RUSTFS_CONSOLE_ADDRESS=":9001" + - RUSTFS_CONSOLE_ENABLE=true + - RUSTFS_OBS_LOGGER_LEVEL=error + - RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" # ... other configurations ``` @@ -271,8 +280,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ -e RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" \ rustfs/rustfs:latest ``` diff --git a/content/de/installation/container/podman.md b/content/de/installation/container/podman.md index db508c6a..5c478328 100644 --- a/content/de/installation/container/podman.md +++ b/content/de/installation/container/podman.md @@ -31,8 +31,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs:latest \ /data ``` diff --git a/content/de/installation/linux/multiple-node-multiple-disk.md b/content/de/installation/linux/multiple-node-multiple-disk.md index a88d4253..797c9cd9 100644 --- a/content/de/installation/linux/multiple-node-multiple-disk.md +++ b/content/de/installation/linux/multiple-node-multiple-disk.md @@ -82,8 +82,8 @@ The access key, secret key, and `RUSTFS_VOLUMES` value must be identical on all 2. Create the storage and log directories on every node: ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -109,7 +109,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter any node's IP address (or the load balancer address) and the console port (default 9001) in a browser. You should see: diff --git a/content/de/installation/linux/prerequisites-and-service.md b/content/de/installation/linux/prerequisites-and-service.md index 0714609f..8917c54e 100644 --- a/content/de/installation/linux/prerequisites-and-service.md +++ b/content/de/installation/linux/prerequisites-and-service.md @@ -206,8 +206,8 @@ RestrictSUIDSGID=true RestrictRealtime=true # service log configuration -StandardOutput=append:/var/logs/rustfs/rustfs.log -StandardError=append:/var/logs/rustfs/rustfs-err.log +StandardOutput=append:/var/log/rustfs/rustfs.log +StandardError=append:/var/log/rustfs/rustfs-err.log [Install] WantedBy=multi-user.target diff --git a/content/de/installation/linux/single-node-multiple-disk.md b/content/de/installation/linux/single-node-multiple-disk.md index df6f2135..4f4c2690 100644 --- a/content/de/installation/linux/single-node-multiple-disk.md +++ b/content/de/installation/linux/single-node-multiple-disk.md @@ -51,8 +51,8 @@ RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" 2. Create the storage and log directories: ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -78,7 +78,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter the server's IP address and the console port (default 9001) in a browser. You should see: diff --git a/content/de/installation/linux/single-node-single-disk.md b/content/de/installation/linux/single-node-single-disk.md index 8e83ffce..b6c96e62 100644 --- a/content/de/installation/linux/single-node-single-disk.md +++ b/content/de/installation/linux/single-node-single-disk.md @@ -50,8 +50,8 @@ RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" 2. Create the storage and log directories: ```bash -sudo mkdir -p /data/rustfs0 /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs0 /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -77,7 +77,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter the server's IP address and the console port (default 9001) in a browser. You should see: diff --git a/content/de/operations/observability.md b/content/de/operations/observability.md index 2496cb2e..b0531ca3 100644 --- a/content/de/operations/observability.md +++ b/content/de/operations/observability.md @@ -209,13 +209,16 @@ Per-disk usage and disk online/offline state are currently surfaced through the Where logs go is controlled by `RUSTFS_OBS_LOG_DIRECTORY`: - **Unset** — logs go to stdout. In containers, use your log driver; on systemd hosts, stdout/stderr is captured by **journald**, so `journalctl -u rustfs -f` works without extra configuration. -- **A local directory** (e.g. `/logs`) — RustFS writes rotating log files there. Rotation is tuned with `RUSTFS_OBS_LOG_FILENAME`, `RUSTFS_OBS_LOG_ROTATION_SIZE_MB`, `RUSTFS_OBS_LOG_ROTATION_TIME`, and `RUSTFS_OBS_LOG_KEEP_FILES`. +- **A local directory** (e.g. `/var/log/rustfs/`) — RustFS writes rotating log files there. Rotation is tuned with `RUSTFS_OBS_LOG_FILENAME`, `RUSTFS_OBS_LOG_ROTATION_SIZE_MB`, `RUSTFS_OBS_LOG_ROTATION_TIME`, and `RUSTFS_OBS_LOG_KEEP_FILES`. - **A URL** (contains `://`) — logs are shipped to a remote endpoint. When `RUSTFS_OBS_ENDPOINT` is set and log export is enabled, logs are additionally exported via OTLP; the reference stack routes them into Loki for querying from Grafana. ```bash title="Example: file logs plus OTLP export" -RUSTFS_OBS_LOG_DIRECTORY=/var/log/rustfs -RUSTFS_OBS_LOGGER_LEVEL=info +RUSTFS_ADDRESS=":9000" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" RUSTFS_OBS_ENDPOINT=http://otel-collector:4318 ``` diff --git a/content/de/operations/upgrade/container/index.md b/content/de/operations/upgrade/container/index.md index 093d1e9c..e9e388f1 100644 --- a/content/de/operations/upgrade/container/index.md +++ b/content/de/operations/upgrade/container/index.md @@ -50,8 +50,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs: \ /data ``` @@ -85,8 +88,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs: \ /data ``` diff --git a/content/de/troubleshooting/driver.md b/content/de/troubleshooting/driver.md index 19176e8c..f0d48390 100644 --- a/content/de/troubleshooting/driver.md +++ b/content/de/troubleshooting/driver.md @@ -118,7 +118,7 @@ Once RustFS detects a freshly formatted disk at a known mount point, its backgro journalctl -u rustfs -f # Or view the log files under the directory set by RUSTFS_OBS_LOG_DIRECTORY -tail -f /var/logs/rustfs/rustfs.log +tail -f /var/log/rustfs/rustfs.log ``` You can also open the RustFS Console and check the disk status of the affected node. diff --git a/content/en/administration/console/index.md b/content/en/administration/console/index.md index 489ef506..e8af749f 100644 --- a/content/en/administration/console/index.md +++ b/content/en/administration/console/index.md @@ -10,8 +10,11 @@ The **RustFS Console** is the web administration interface for RustFS. Use this The Console is enabled by default and listens on port `9001`, separately from the S3 API on port `9000`. You can set the behavior explicitly with the following environment variables: ```ini title="/etc/default/rustfs" -RUSTFS_CONSOLE_ENABLE=true +RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` Restart RustFS after changing these values. Set `RUSTFS_CONSOLE_ENABLE=false` when the Console must not run. diff --git a/content/en/developer/integration/big-data/iceberg.md b/content/en/developer/integration/big-data/iceberg.md index 568a3699..9511170c 100644 --- a/content/en/developer/integration/big-data/iceberg.md +++ b/content/en/developer/integration/big-data/iceberg.md @@ -70,9 +70,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/en/developer/integration/big-data/milvus.md b/content/en/developer/integration/big-data/milvus.md index 869be2d3..2b17701b 100644 --- a/content/en/developer/integration/big-data/milvus.md +++ b/content/en/developer/integration/big-data/milvus.md @@ -96,9 +96,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/en/developer/integration/reverse-proxy/caddy.md b/content/en/developer/integration/reverse-proxy/caddy.md index 57c1a55b..cd1c2384 100644 --- a/content/en/developer/integration/reverse-proxy/caddy.md +++ b/content/en/developer/integration/reverse-proxy/caddy.md @@ -109,8 +109,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/en/developer/integration/reverse-proxy/haproxy.md b/content/en/developer/integration/reverse-proxy/haproxy.md index faac09ef..265b88c6 100644 --- a/content/en/developer/integration/reverse-proxy/haproxy.md +++ b/content/en/developer/integration/reverse-proxy/haproxy.md @@ -128,8 +128,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/en/developer/integration/reverse-proxy/nginx.md b/content/en/developer/integration/reverse-proxy/nginx.md index 12eb5230..b7d025c3 100644 --- a/content/en/developer/integration/reverse-proxy/nginx.md +++ b/content/en/developer/integration/reverse-proxy/nginx.md @@ -167,8 +167,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/en/developer/integration/reverse-proxy/traefik.md b/content/en/developer/integration/reverse-proxy/traefik.md index 7e319593..a40c7f42 100644 --- a/content/en/developer/integration/reverse-proxy/traefik.md +++ b/content/en/developer/integration/reverse-proxy/traefik.md @@ -83,8 +83,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/en/installation/container/docker.md b/content/en/installation/container/docker.md index 504937f5..8469df29 100644 --- a/content/en/installation/container/docker.md +++ b/content/en/installation/container/docker.md @@ -32,8 +32,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` diff --git a/content/en/installation/container/index.mdx b/content/en/installation/container/index.mdx index 3d86faa3..27ed2b35 100644 --- a/content/en/installation/container/index.mdx +++ b/content/en/installation/container/index.mdx @@ -76,9 +76,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_ADDRESS=:9000 \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` @@ -122,8 +124,11 @@ docker run -d \ -p 9000:9000 \ -p 9001:9001 \ -v /mnt/data:/data \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ --console-enable \ /data @@ -175,7 +180,7 @@ Running the command under root directory, docker compose --profile observability up -d ``` -Providing the necessary permissions. An initialization container is necessary to grant the correct access rights to rustfs using the `depends_on` keyword. In the example below the `rustfs_perms` service is added to the `docker-compose.yml` to handle this. To ensure logs are persisted and accessible, we map the host log directory to the container's `/logs` path +Providing the necessary permissions. An initialization container is necessary to grant the correct access rights to rustfs using the `depends_on` keyword. In the example below the `rustfs_perms` service is added to the `docker-compose.yml` to handle this. To ensure logs are persisted and accessible, we map the host log directory to the container's `/var/log/rustfs/` path ```yaml title="docker-compose.yml" services: @@ -194,9 +199,13 @@ Providing the necessary permissions. An initialization container is necessary to condition: service_completed_successfully volumes: - /path/to_host_directory/volumes/data:/data - - /path/to_host_directory/volumes/logs:/logs + - /path/to_host_directory/volumes/logs:/var/log/rustfs/ environment: - - RUSTFS_OBS_LOG_DIRECTORY=/logs + - RUSTFS_ADDRESS=":9000" + - RUSTFS_CONSOLE_ADDRESS=":9001" + - RUSTFS_CONSOLE_ENABLE=true + - RUSTFS_OBS_LOGGER_LEVEL=error + - RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" # ... other configurations ``` @@ -271,8 +280,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ -e RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" \ rustfs/rustfs:latest ``` diff --git a/content/en/installation/container/podman.md b/content/en/installation/container/podman.md index db508c6a..5c478328 100644 --- a/content/en/installation/container/podman.md +++ b/content/en/installation/container/podman.md @@ -31,8 +31,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs:latest \ /data ``` diff --git a/content/en/installation/linux/multiple-node-multiple-disk.md b/content/en/installation/linux/multiple-node-multiple-disk.md index a88d4253..797c9cd9 100644 --- a/content/en/installation/linux/multiple-node-multiple-disk.md +++ b/content/en/installation/linux/multiple-node-multiple-disk.md @@ -82,8 +82,8 @@ The access key, secret key, and `RUSTFS_VOLUMES` value must be identical on all 2. Create the storage and log directories on every node: ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -109,7 +109,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter any node's IP address (or the load balancer address) and the console port (default 9001) in a browser. You should see: diff --git a/content/en/installation/linux/prerequisites-and-service.md b/content/en/installation/linux/prerequisites-and-service.md index 0714609f..8917c54e 100644 --- a/content/en/installation/linux/prerequisites-and-service.md +++ b/content/en/installation/linux/prerequisites-and-service.md @@ -206,8 +206,8 @@ RestrictSUIDSGID=true RestrictRealtime=true # service log configuration -StandardOutput=append:/var/logs/rustfs/rustfs.log -StandardError=append:/var/logs/rustfs/rustfs-err.log +StandardOutput=append:/var/log/rustfs/rustfs.log +StandardError=append:/var/log/rustfs/rustfs-err.log [Install] WantedBy=multi-user.target diff --git a/content/en/installation/linux/single-node-multiple-disk.md b/content/en/installation/linux/single-node-multiple-disk.md index df6f2135..4f4c2690 100644 --- a/content/en/installation/linux/single-node-multiple-disk.md +++ b/content/en/installation/linux/single-node-multiple-disk.md @@ -51,8 +51,8 @@ RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" 2. Create the storage and log directories: ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -78,7 +78,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter the server's IP address and the console port (default 9001) in a browser. You should see: diff --git a/content/en/installation/linux/single-node-single-disk.md b/content/en/installation/linux/single-node-single-disk.md index 8e83ffce..b6c96e62 100644 --- a/content/en/installation/linux/single-node-single-disk.md +++ b/content/en/installation/linux/single-node-single-disk.md @@ -50,8 +50,8 @@ RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" 2. Create the storage and log directories: ```bash -sudo mkdir -p /data/rustfs0 /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs0 /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -77,7 +77,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter the server's IP address and the console port (default 9001) in a browser. You should see: diff --git a/content/en/operations/observability.md b/content/en/operations/observability.md index 2496cb2e..b0531ca3 100644 --- a/content/en/operations/observability.md +++ b/content/en/operations/observability.md @@ -209,13 +209,16 @@ Per-disk usage and disk online/offline state are currently surfaced through the Where logs go is controlled by `RUSTFS_OBS_LOG_DIRECTORY`: - **Unset** — logs go to stdout. In containers, use your log driver; on systemd hosts, stdout/stderr is captured by **journald**, so `journalctl -u rustfs -f` works without extra configuration. -- **A local directory** (e.g. `/logs`) — RustFS writes rotating log files there. Rotation is tuned with `RUSTFS_OBS_LOG_FILENAME`, `RUSTFS_OBS_LOG_ROTATION_SIZE_MB`, `RUSTFS_OBS_LOG_ROTATION_TIME`, and `RUSTFS_OBS_LOG_KEEP_FILES`. +- **A local directory** (e.g. `/var/log/rustfs/`) — RustFS writes rotating log files there. Rotation is tuned with `RUSTFS_OBS_LOG_FILENAME`, `RUSTFS_OBS_LOG_ROTATION_SIZE_MB`, `RUSTFS_OBS_LOG_ROTATION_TIME`, and `RUSTFS_OBS_LOG_KEEP_FILES`. - **A URL** (contains `://`) — logs are shipped to a remote endpoint. When `RUSTFS_OBS_ENDPOINT` is set and log export is enabled, logs are additionally exported via OTLP; the reference stack routes them into Loki for querying from Grafana. ```bash title="Example: file logs plus OTLP export" -RUSTFS_OBS_LOG_DIRECTORY=/var/log/rustfs -RUSTFS_OBS_LOGGER_LEVEL=info +RUSTFS_ADDRESS=":9000" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" RUSTFS_OBS_ENDPOINT=http://otel-collector:4318 ``` diff --git a/content/en/operations/upgrade/container/index.md b/content/en/operations/upgrade/container/index.md index 093d1e9c..e9e388f1 100644 --- a/content/en/operations/upgrade/container/index.md +++ b/content/en/operations/upgrade/container/index.md @@ -50,8 +50,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs: \ /data ``` @@ -85,8 +88,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs: \ /data ``` diff --git a/content/en/troubleshooting/driver.md b/content/en/troubleshooting/driver.md index 19176e8c..f0d48390 100644 --- a/content/en/troubleshooting/driver.md +++ b/content/en/troubleshooting/driver.md @@ -118,7 +118,7 @@ Once RustFS detects a freshly formatted disk at a known mount point, its backgro journalctl -u rustfs -f # Or view the log files under the directory set by RUSTFS_OBS_LOG_DIRECTORY -tail -f /var/logs/rustfs/rustfs.log +tail -f /var/log/rustfs/rustfs.log ``` You can also open the RustFS Console and check the disk status of the affected node. diff --git a/content/fr/administration/console/index.md b/content/fr/administration/console/index.md index 489ef506..e8af749f 100644 --- a/content/fr/administration/console/index.md +++ b/content/fr/administration/console/index.md @@ -10,8 +10,11 @@ The **RustFS Console** is the web administration interface for RustFS. Use this The Console is enabled by default and listens on port `9001`, separately from the S3 API on port `9000`. You can set the behavior explicitly with the following environment variables: ```ini title="/etc/default/rustfs" -RUSTFS_CONSOLE_ENABLE=true +RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` Restart RustFS after changing these values. Set `RUSTFS_CONSOLE_ENABLE=false` when the Console must not run. diff --git a/content/fr/developer/integration/big-data/iceberg.md b/content/fr/developer/integration/big-data/iceberg.md index 568a3699..9511170c 100644 --- a/content/fr/developer/integration/big-data/iceberg.md +++ b/content/fr/developer/integration/big-data/iceberg.md @@ -70,9 +70,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/fr/developer/integration/big-data/milvus.md b/content/fr/developer/integration/big-data/milvus.md index 869be2d3..2b17701b 100644 --- a/content/fr/developer/integration/big-data/milvus.md +++ b/content/fr/developer/integration/big-data/milvus.md @@ -96,9 +96,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/fr/developer/integration/reverse-proxy/caddy.md b/content/fr/developer/integration/reverse-proxy/caddy.md index 57c1a55b..cd1c2384 100644 --- a/content/fr/developer/integration/reverse-proxy/caddy.md +++ b/content/fr/developer/integration/reverse-proxy/caddy.md @@ -109,8 +109,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/fr/developer/integration/reverse-proxy/haproxy.md b/content/fr/developer/integration/reverse-proxy/haproxy.md index faac09ef..265b88c6 100644 --- a/content/fr/developer/integration/reverse-proxy/haproxy.md +++ b/content/fr/developer/integration/reverse-proxy/haproxy.md @@ -128,8 +128,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/fr/developer/integration/reverse-proxy/nginx.md b/content/fr/developer/integration/reverse-proxy/nginx.md index 12eb5230..b7d025c3 100644 --- a/content/fr/developer/integration/reverse-proxy/nginx.md +++ b/content/fr/developer/integration/reverse-proxy/nginx.md @@ -167,8 +167,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/fr/developer/integration/reverse-proxy/traefik.md b/content/fr/developer/integration/reverse-proxy/traefik.md index 7e319593..a40c7f42 100644 --- a/content/fr/developer/integration/reverse-proxy/traefik.md +++ b/content/fr/developer/integration/reverse-proxy/traefik.md @@ -83,8 +83,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/fr/installation/container/docker.md b/content/fr/installation/container/docker.md index 504937f5..8469df29 100644 --- a/content/fr/installation/container/docker.md +++ b/content/fr/installation/container/docker.md @@ -32,8 +32,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` diff --git a/content/fr/installation/container/index.mdx b/content/fr/installation/container/index.mdx index 3d86faa3..27ed2b35 100644 --- a/content/fr/installation/container/index.mdx +++ b/content/fr/installation/container/index.mdx @@ -76,9 +76,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_ADDRESS=:9000 \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` @@ -122,8 +124,11 @@ docker run -d \ -p 9000:9000 \ -p 9001:9001 \ -v /mnt/data:/data \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ --console-enable \ /data @@ -175,7 +180,7 @@ Running the command under root directory, docker compose --profile observability up -d ``` -Providing the necessary permissions. An initialization container is necessary to grant the correct access rights to rustfs using the `depends_on` keyword. In the example below the `rustfs_perms` service is added to the `docker-compose.yml` to handle this. To ensure logs are persisted and accessible, we map the host log directory to the container's `/logs` path +Providing the necessary permissions. An initialization container is necessary to grant the correct access rights to rustfs using the `depends_on` keyword. In the example below the `rustfs_perms` service is added to the `docker-compose.yml` to handle this. To ensure logs are persisted and accessible, we map the host log directory to the container's `/var/log/rustfs/` path ```yaml title="docker-compose.yml" services: @@ -194,9 +199,13 @@ Providing the necessary permissions. An initialization container is necessary to condition: service_completed_successfully volumes: - /path/to_host_directory/volumes/data:/data - - /path/to_host_directory/volumes/logs:/logs + - /path/to_host_directory/volumes/logs:/var/log/rustfs/ environment: - - RUSTFS_OBS_LOG_DIRECTORY=/logs + - RUSTFS_ADDRESS=":9000" + - RUSTFS_CONSOLE_ADDRESS=":9001" + - RUSTFS_CONSOLE_ENABLE=true + - RUSTFS_OBS_LOGGER_LEVEL=error + - RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" # ... other configurations ``` @@ -271,8 +280,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ -e RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" \ rustfs/rustfs:latest ``` diff --git a/content/fr/installation/container/podman.md b/content/fr/installation/container/podman.md index db508c6a..5c478328 100644 --- a/content/fr/installation/container/podman.md +++ b/content/fr/installation/container/podman.md @@ -31,8 +31,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs:latest \ /data ``` diff --git a/content/fr/installation/linux/multiple-node-multiple-disk.md b/content/fr/installation/linux/multiple-node-multiple-disk.md index a88d4253..797c9cd9 100644 --- a/content/fr/installation/linux/multiple-node-multiple-disk.md +++ b/content/fr/installation/linux/multiple-node-multiple-disk.md @@ -82,8 +82,8 @@ The access key, secret key, and `RUSTFS_VOLUMES` value must be identical on all 2. Create the storage and log directories on every node: ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -109,7 +109,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter any node's IP address (or the load balancer address) and the console port (default 9001) in a browser. You should see: diff --git a/content/fr/installation/linux/prerequisites-and-service.md b/content/fr/installation/linux/prerequisites-and-service.md index 0714609f..8917c54e 100644 --- a/content/fr/installation/linux/prerequisites-and-service.md +++ b/content/fr/installation/linux/prerequisites-and-service.md @@ -206,8 +206,8 @@ RestrictSUIDSGID=true RestrictRealtime=true # service log configuration -StandardOutput=append:/var/logs/rustfs/rustfs.log -StandardError=append:/var/logs/rustfs/rustfs-err.log +StandardOutput=append:/var/log/rustfs/rustfs.log +StandardError=append:/var/log/rustfs/rustfs-err.log [Install] WantedBy=multi-user.target diff --git a/content/fr/installation/linux/single-node-multiple-disk.md b/content/fr/installation/linux/single-node-multiple-disk.md index df6f2135..4f4c2690 100644 --- a/content/fr/installation/linux/single-node-multiple-disk.md +++ b/content/fr/installation/linux/single-node-multiple-disk.md @@ -51,8 +51,8 @@ RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" 2. Create the storage and log directories: ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -78,7 +78,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter the server's IP address and the console port (default 9001) in a browser. You should see: diff --git a/content/fr/installation/linux/single-node-single-disk.md b/content/fr/installation/linux/single-node-single-disk.md index 8e83ffce..b6c96e62 100644 --- a/content/fr/installation/linux/single-node-single-disk.md +++ b/content/fr/installation/linux/single-node-single-disk.md @@ -50,8 +50,8 @@ RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" 2. Create the storage and log directories: ```bash -sudo mkdir -p /data/rustfs0 /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs0 /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -77,7 +77,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter the server's IP address and the console port (default 9001) in a browser. You should see: diff --git a/content/fr/operations/observability.md b/content/fr/operations/observability.md index 2496cb2e..b0531ca3 100644 --- a/content/fr/operations/observability.md +++ b/content/fr/operations/observability.md @@ -209,13 +209,16 @@ Per-disk usage and disk online/offline state are currently surfaced through the Where logs go is controlled by `RUSTFS_OBS_LOG_DIRECTORY`: - **Unset** — logs go to stdout. In containers, use your log driver; on systemd hosts, stdout/stderr is captured by **journald**, so `journalctl -u rustfs -f` works without extra configuration. -- **A local directory** (e.g. `/logs`) — RustFS writes rotating log files there. Rotation is tuned with `RUSTFS_OBS_LOG_FILENAME`, `RUSTFS_OBS_LOG_ROTATION_SIZE_MB`, `RUSTFS_OBS_LOG_ROTATION_TIME`, and `RUSTFS_OBS_LOG_KEEP_FILES`. +- **A local directory** (e.g. `/var/log/rustfs/`) — RustFS writes rotating log files there. Rotation is tuned with `RUSTFS_OBS_LOG_FILENAME`, `RUSTFS_OBS_LOG_ROTATION_SIZE_MB`, `RUSTFS_OBS_LOG_ROTATION_TIME`, and `RUSTFS_OBS_LOG_KEEP_FILES`. - **A URL** (contains `://`) — logs are shipped to a remote endpoint. When `RUSTFS_OBS_ENDPOINT` is set and log export is enabled, logs are additionally exported via OTLP; the reference stack routes them into Loki for querying from Grafana. ```bash title="Example: file logs plus OTLP export" -RUSTFS_OBS_LOG_DIRECTORY=/var/log/rustfs -RUSTFS_OBS_LOGGER_LEVEL=info +RUSTFS_ADDRESS=":9000" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" RUSTFS_OBS_ENDPOINT=http://otel-collector:4318 ``` diff --git a/content/fr/operations/upgrade/container/index.md b/content/fr/operations/upgrade/container/index.md index 093d1e9c..e9e388f1 100644 --- a/content/fr/operations/upgrade/container/index.md +++ b/content/fr/operations/upgrade/container/index.md @@ -50,8 +50,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs: \ /data ``` @@ -85,8 +88,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs: \ /data ``` diff --git a/content/fr/troubleshooting/driver.md b/content/fr/troubleshooting/driver.md index 19176e8c..f0d48390 100644 --- a/content/fr/troubleshooting/driver.md +++ b/content/fr/troubleshooting/driver.md @@ -118,7 +118,7 @@ Once RustFS detects a freshly formatted disk at a known mount point, its backgro journalctl -u rustfs -f # Or view the log files under the directory set by RUSTFS_OBS_LOG_DIRECTORY -tail -f /var/logs/rustfs/rustfs.log +tail -f /var/log/rustfs/rustfs.log ``` You can also open the RustFS Console and check the disk status of the affected node. diff --git a/content/ja/administration/console/index.md b/content/ja/administration/console/index.md index 489ef506..e8af749f 100644 --- a/content/ja/administration/console/index.md +++ b/content/ja/administration/console/index.md @@ -10,8 +10,11 @@ The **RustFS Console** is the web administration interface for RustFS. Use this The Console is enabled by default and listens on port `9001`, separately from the S3 API on port `9000`. You can set the behavior explicitly with the following environment variables: ```ini title="/etc/default/rustfs" -RUSTFS_CONSOLE_ENABLE=true +RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` Restart RustFS after changing these values. Set `RUSTFS_CONSOLE_ENABLE=false` when the Console must not run. diff --git a/content/ja/developer/integration/big-data/iceberg.md b/content/ja/developer/integration/big-data/iceberg.md index 568a3699..9511170c 100644 --- a/content/ja/developer/integration/big-data/iceberg.md +++ b/content/ja/developer/integration/big-data/iceberg.md @@ -70,9 +70,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/ja/developer/integration/big-data/milvus.md b/content/ja/developer/integration/big-data/milvus.md index 869be2d3..2b17701b 100644 --- a/content/ja/developer/integration/big-data/milvus.md +++ b/content/ja/developer/integration/big-data/milvus.md @@ -96,9 +96,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/ja/developer/integration/reverse-proxy/caddy.md b/content/ja/developer/integration/reverse-proxy/caddy.md index 57c1a55b..cd1c2384 100644 --- a/content/ja/developer/integration/reverse-proxy/caddy.md +++ b/content/ja/developer/integration/reverse-proxy/caddy.md @@ -109,8 +109,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/ja/developer/integration/reverse-proxy/haproxy.md b/content/ja/developer/integration/reverse-proxy/haproxy.md index faac09ef..265b88c6 100644 --- a/content/ja/developer/integration/reverse-proxy/haproxy.md +++ b/content/ja/developer/integration/reverse-proxy/haproxy.md @@ -128,8 +128,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/ja/developer/integration/reverse-proxy/nginx.md b/content/ja/developer/integration/reverse-proxy/nginx.md index 12eb5230..b7d025c3 100644 --- a/content/ja/developer/integration/reverse-proxy/nginx.md +++ b/content/ja/developer/integration/reverse-proxy/nginx.md @@ -167,8 +167,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/ja/developer/integration/reverse-proxy/traefik.md b/content/ja/developer/integration/reverse-proxy/traefik.md index 7e319593..a40c7f42 100644 --- a/content/ja/developer/integration/reverse-proxy/traefik.md +++ b/content/ja/developer/integration/reverse-proxy/traefik.md @@ -83,8 +83,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/ja/installation/container/docker.md b/content/ja/installation/container/docker.md index 504937f5..8469df29 100644 --- a/content/ja/installation/container/docker.md +++ b/content/ja/installation/container/docker.md @@ -32,8 +32,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` diff --git a/content/ja/installation/container/index.mdx b/content/ja/installation/container/index.mdx index 3d86faa3..27ed2b35 100644 --- a/content/ja/installation/container/index.mdx +++ b/content/ja/installation/container/index.mdx @@ -76,9 +76,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_ADDRESS=:9000 \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` @@ -122,8 +124,11 @@ docker run -d \ -p 9000:9000 \ -p 9001:9001 \ -v /mnt/data:/data \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ --console-enable \ /data @@ -175,7 +180,7 @@ Running the command under root directory, docker compose --profile observability up -d ``` -Providing the necessary permissions. An initialization container is necessary to grant the correct access rights to rustfs using the `depends_on` keyword. In the example below the `rustfs_perms` service is added to the `docker-compose.yml` to handle this. To ensure logs are persisted and accessible, we map the host log directory to the container's `/logs` path +Providing the necessary permissions. An initialization container is necessary to grant the correct access rights to rustfs using the `depends_on` keyword. In the example below the `rustfs_perms` service is added to the `docker-compose.yml` to handle this. To ensure logs are persisted and accessible, we map the host log directory to the container's `/var/log/rustfs/` path ```yaml title="docker-compose.yml" services: @@ -194,9 +199,13 @@ Providing the necessary permissions. An initialization container is necessary to condition: service_completed_successfully volumes: - /path/to_host_directory/volumes/data:/data - - /path/to_host_directory/volumes/logs:/logs + - /path/to_host_directory/volumes/logs:/var/log/rustfs/ environment: - - RUSTFS_OBS_LOG_DIRECTORY=/logs + - RUSTFS_ADDRESS=":9000" + - RUSTFS_CONSOLE_ADDRESS=":9001" + - RUSTFS_CONSOLE_ENABLE=true + - RUSTFS_OBS_LOGGER_LEVEL=error + - RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" # ... other configurations ``` @@ -271,8 +280,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ -e RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" \ rustfs/rustfs:latest ``` diff --git a/content/ja/installation/container/podman.md b/content/ja/installation/container/podman.md index db508c6a..5c478328 100644 --- a/content/ja/installation/container/podman.md +++ b/content/ja/installation/container/podman.md @@ -31,8 +31,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs:latest \ /data ``` diff --git a/content/ja/installation/linux/multiple-node-multiple-disk.md b/content/ja/installation/linux/multiple-node-multiple-disk.md index a88d4253..797c9cd9 100644 --- a/content/ja/installation/linux/multiple-node-multiple-disk.md +++ b/content/ja/installation/linux/multiple-node-multiple-disk.md @@ -82,8 +82,8 @@ The access key, secret key, and `RUSTFS_VOLUMES` value must be identical on all 2. Create the storage and log directories on every node: ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -109,7 +109,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter any node's IP address (or the load balancer address) and the console port (default 9001) in a browser. You should see: diff --git a/content/ja/installation/linux/prerequisites-and-service.md b/content/ja/installation/linux/prerequisites-and-service.md index 0714609f..8917c54e 100644 --- a/content/ja/installation/linux/prerequisites-and-service.md +++ b/content/ja/installation/linux/prerequisites-and-service.md @@ -206,8 +206,8 @@ RestrictSUIDSGID=true RestrictRealtime=true # service log configuration -StandardOutput=append:/var/logs/rustfs/rustfs.log -StandardError=append:/var/logs/rustfs/rustfs-err.log +StandardOutput=append:/var/log/rustfs/rustfs.log +StandardError=append:/var/log/rustfs/rustfs-err.log [Install] WantedBy=multi-user.target diff --git a/content/ja/installation/linux/single-node-multiple-disk.md b/content/ja/installation/linux/single-node-multiple-disk.md index df6f2135..4f4c2690 100644 --- a/content/ja/installation/linux/single-node-multiple-disk.md +++ b/content/ja/installation/linux/single-node-multiple-disk.md @@ -51,8 +51,8 @@ RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" 2. Create the storage and log directories: ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -78,7 +78,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter the server's IP address and the console port (default 9001) in a browser. You should see: diff --git a/content/ja/installation/linux/single-node-single-disk.md b/content/ja/installation/linux/single-node-single-disk.md index 8e83ffce..b6c96e62 100644 --- a/content/ja/installation/linux/single-node-single-disk.md +++ b/content/ja/installation/linux/single-node-single-disk.md @@ -50,8 +50,8 @@ RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" 2. Create the storage and log directories: ```bash -sudo mkdir -p /data/rustfs0 /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs0 /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -77,7 +77,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter the server's IP address and the console port (default 9001) in a browser. You should see: diff --git a/content/ja/operations/observability.md b/content/ja/operations/observability.md index 2496cb2e..b0531ca3 100644 --- a/content/ja/operations/observability.md +++ b/content/ja/operations/observability.md @@ -209,13 +209,16 @@ Per-disk usage and disk online/offline state are currently surfaced through the Where logs go is controlled by `RUSTFS_OBS_LOG_DIRECTORY`: - **Unset** — logs go to stdout. In containers, use your log driver; on systemd hosts, stdout/stderr is captured by **journald**, so `journalctl -u rustfs -f` works without extra configuration. -- **A local directory** (e.g. `/logs`) — RustFS writes rotating log files there. Rotation is tuned with `RUSTFS_OBS_LOG_FILENAME`, `RUSTFS_OBS_LOG_ROTATION_SIZE_MB`, `RUSTFS_OBS_LOG_ROTATION_TIME`, and `RUSTFS_OBS_LOG_KEEP_FILES`. +- **A local directory** (e.g. `/var/log/rustfs/`) — RustFS writes rotating log files there. Rotation is tuned with `RUSTFS_OBS_LOG_FILENAME`, `RUSTFS_OBS_LOG_ROTATION_SIZE_MB`, `RUSTFS_OBS_LOG_ROTATION_TIME`, and `RUSTFS_OBS_LOG_KEEP_FILES`. - **A URL** (contains `://`) — logs are shipped to a remote endpoint. When `RUSTFS_OBS_ENDPOINT` is set and log export is enabled, logs are additionally exported via OTLP; the reference stack routes them into Loki for querying from Grafana. ```bash title="Example: file logs plus OTLP export" -RUSTFS_OBS_LOG_DIRECTORY=/var/log/rustfs -RUSTFS_OBS_LOGGER_LEVEL=info +RUSTFS_ADDRESS=":9000" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" RUSTFS_OBS_ENDPOINT=http://otel-collector:4318 ``` diff --git a/content/ja/operations/upgrade/container/index.md b/content/ja/operations/upgrade/container/index.md index 093d1e9c..e9e388f1 100644 --- a/content/ja/operations/upgrade/container/index.md +++ b/content/ja/operations/upgrade/container/index.md @@ -50,8 +50,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs: \ /data ``` @@ -85,8 +88,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs: \ /data ``` diff --git a/content/ja/troubleshooting/driver.md b/content/ja/troubleshooting/driver.md index 19176e8c..f0d48390 100644 --- a/content/ja/troubleshooting/driver.md +++ b/content/ja/troubleshooting/driver.md @@ -118,7 +118,7 @@ Once RustFS detects a freshly formatted disk at a known mount point, its backgro journalctl -u rustfs -f # Or view the log files under the directory set by RUSTFS_OBS_LOG_DIRECTORY -tail -f /var/logs/rustfs/rustfs.log +tail -f /var/log/rustfs/rustfs.log ``` You can also open the RustFS Console and check the disk status of the affected node. diff --git a/content/zh/administration/console/index.md b/content/zh/administration/console/index.md index bd687705..7ec7101c 100644 --- a/content/zh/administration/console/index.md +++ b/content/zh/administration/console/index.md @@ -10,8 +10,11 @@ description: "启用 RustFS 控制台，将其连接到服务器并安全登录 控制台默认启用并监听端口 `9001`，与端口 `9000` 上的 S3 API 分开。你可以使用以下环境变量显式设置其行为： ```ini title="/etc/default/rustfs" -RUSTFS_CONSOLE_ENABLE=true +RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 更改这些值后请重启 RustFS。如果不应运行控制台，请设置 `RUSTFS_CONSOLE_ENABLE=false`。 diff --git a/content/zh/developer/integration/big-data/iceberg.md b/content/zh/developer/integration/big-data/iceberg.md index bb45f445..521af853 100644 --- a/content/zh/developer/integration/big-data/iceberg.md +++ b/content/zh/developer/integration/big-data/iceberg.md @@ -70,9 +70,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/zh/developer/integration/big-data/milvus.md b/content/zh/developer/integration/big-data/milvus.md index 3170a287..012218ee 100644 --- a/content/zh/developer/integration/big-data/milvus.md +++ b/content/zh/developer/integration/big-data/milvus.md @@ -96,9 +96,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/zh/developer/integration/reverse-proxy/caddy.md b/content/zh/developer/integration/reverse-proxy/caddy.md index e2d3241b..2a1b6baf 100644 --- a/content/zh/developer/integration/reverse-proxy/caddy.md +++ b/content/zh/developer/integration/reverse-proxy/caddy.md @@ -109,8 +109,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/zh/developer/integration/reverse-proxy/haproxy.md b/content/zh/developer/integration/reverse-proxy/haproxy.md index 2ec3e1c1..e21d0574 100644 --- a/content/zh/developer/integration/reverse-proxy/haproxy.md +++ b/content/zh/developer/integration/reverse-proxy/haproxy.md @@ -128,8 +128,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/zh/developer/integration/reverse-proxy/nginx.md b/content/zh/developer/integration/reverse-proxy/nginx.md index eecc77f2..5986a7be 100644 --- a/content/zh/developer/integration/reverse-proxy/nginx.md +++ b/content/zh/developer/integration/reverse-proxy/nginx.md @@ -167,8 +167,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/zh/developer/integration/reverse-proxy/traefik.md b/content/zh/developer/integration/reverse-proxy/traefik.md index 582a0454..4fb67c33 100644 --- a/content/zh/developer/integration/reverse-proxy/traefik.md +++ b/content/zh/developer/integration/reverse-proxy/traefik.md @@ -83,8 +83,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/zh/installation/container/docker.md b/content/zh/installation/container/docker.md index 4c682ea0..63fd2915 100644 --- a/content/zh/installation/container/docker.md +++ b/content/zh/installation/container/docker.md @@ -32,8 +32,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` diff --git a/content/zh/installation/container/index.mdx b/content/zh/installation/container/index.mdx index 44bfc674..6c298bee 100644 --- a/content/zh/installation/container/index.mdx +++ b/content/zh/installation/container/index.mdx @@ -76,9 +76,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_ADDRESS=:9000 \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` @@ -122,8 +124,11 @@ docker run -d \ -p 9000:9000 \ -p 9001:9001 \ -v /mnt/data:/data \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ --console-enable \ /data @@ -175,7 +180,7 @@ git clone https://github.com/rustfs/rustfs.git docker compose --profile observability up -d ``` -提供必要的权限。需要使用初始化容器，通过 `depends_on` 关键字为 rustfs 授予正确的访问权限。以下示例将 `rustfs_perms` 服务添加到 `docker-compose.yml` 来处理权限。为了确保日志持久化且可访问，将主机日志目录映射到容器的 `/logs` 路径： +提供必要的权限。需要使用初始化容器，通过 `depends_on` 关键字为 rustfs 授予正确的访问权限。以下示例将 `rustfs_perms` 服务添加到 `docker-compose.yml` 来处理权限。为了确保日志持久化且可访问，将主机日志目录映射到容器的 `/var/log/rustfs/` 路径： ```yaml title="docker-compose.yml" services: @@ -194,9 +199,13 @@ docker compose --profile observability up -d condition: service_completed_successfully volumes: - /path/to_host_directory/volumes/data:/data - - /path/to_host_directory/volumes/logs:/logs + - /path/to_host_directory/volumes/logs:/var/log/rustfs/ environment: - - RUSTFS_OBS_LOG_DIRECTORY=/logs + - RUSTFS_ADDRESS=":9000" + - RUSTFS_CONSOLE_ADDRESS=":9001" + - RUSTFS_CONSOLE_ENABLE=true + - RUSTFS_OBS_LOGGER_LEVEL=error + - RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" # ... other configurations ``` @@ -271,8 +280,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ -e RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" \ rustfs/rustfs:latest ``` diff --git a/content/zh/installation/container/podman.md b/content/zh/installation/container/podman.md index 532f6870..c33620da 100644 --- a/content/zh/installation/container/podman.md +++ b/content/zh/installation/container/podman.md @@ -31,8 +31,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs:latest \ /data ``` diff --git a/content/zh/installation/linux/multiple-node-multiple-disk.md b/content/zh/installation/linux/multiple-node-multiple-disk.md index 3bbde557..8d702d97 100644 --- a/content/zh/installation/linux/multiple-node-multiple-disk.md +++ b/content/zh/installation/linux/multiple-node-multiple-disk.md @@ -82,8 +82,8 @@ RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" 2. 在每个节点上创建存储和日志目录： ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## 启动服务并验证 @@ -109,7 +109,7 @@ netstat -ntpl 4. 查看日志文件： ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. 访问控制台：在浏览器中输入任一节点的 IP 地址（或负载均衡器地址）和控制台端口（默认 9001）。你将看到： diff --git a/content/zh/installation/linux/prerequisites-and-service.md b/content/zh/installation/linux/prerequisites-and-service.md index 366a6060..d14f1cc1 100644 --- a/content/zh/installation/linux/prerequisites-and-service.md +++ b/content/zh/installation/linux/prerequisites-and-service.md @@ -206,8 +206,8 @@ RestrictSUIDSGID=true RestrictRealtime=true # service log configuration -StandardOutput=append:/var/logs/rustfs/rustfs.log -StandardError=append:/var/logs/rustfs/rustfs-err.log +StandardOutput=append:/var/log/rustfs/rustfs.log +StandardError=append:/var/log/rustfs/rustfs-err.log [Install] WantedBy=multi-user.target diff --git a/content/zh/installation/linux/single-node-multiple-disk.md b/content/zh/installation/linux/single-node-multiple-disk.md index e9671378..1f33793d 100644 --- a/content/zh/installation/linux/single-node-multiple-disk.md +++ b/content/zh/installation/linux/single-node-multiple-disk.md @@ -51,8 +51,8 @@ RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" 2. 创建存储和日志目录： ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## 启动服务并验证 @@ -78,7 +78,7 @@ netstat -ntpl 4. 查看日志文件： ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. 访问控制台：在浏览器中输入服务器 IP 地址和控制台端口（默认 9001）。你将看到： diff --git a/content/zh/installation/linux/single-node-single-disk.md b/content/zh/installation/linux/single-node-single-disk.md index 29e6b2b9..66bc8751 100644 --- a/content/zh/installation/linux/single-node-single-disk.md +++ b/content/zh/installation/linux/single-node-single-disk.md @@ -50,8 +50,8 @@ RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" 2. 创建存储和日志目录： ```bash -sudo mkdir -p /data/rustfs0 /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs0 /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## 启动服务并验证 @@ -77,7 +77,7 @@ netstat -ntpl 4. 查看日志文件： ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. 访问控制台：在浏览器中输入服务器 IP 地址和控制台端口（默认 9001）。你将看到： diff --git a/content/zh/operations/observability.md b/content/zh/operations/observability.md index 893f3139..22ea8414 100644 --- a/content/zh/operations/observability.md +++ b/content/zh/operations/observability.md @@ -209,13 +209,16 @@ scrape_configs: 日志去向由 `RUSTFS_OBS_LOG_DIRECTORY` 控制： - **未设置**：日志写入 stdout。在容器中使用日志驱动；在 systemd 主机上，stdout/stderr 由 **journald** 捕获，因此无需额外配置即可使用 `journalctl -u rustfs -f`。 -- **本地目录**（例如 `/logs`）：RustFS 在其中写入轮换日志文件。使用 `RUSTFS_OBS_LOG_FILENAME`、`RUSTFS_OBS_LOG_ROTATION_SIZE_MB`、`RUSTFS_OBS_LOG_ROTATION_TIME` 和 `RUSTFS_OBS_LOG_KEEP_FILES` 调整轮换。 +- **本地目录**（例如 `/var/log/rustfs/`）：RustFS 在其中写入轮换日志文件。使用 `RUSTFS_OBS_LOG_FILENAME`、`RUSTFS_OBS_LOG_ROTATION_SIZE_MB`、`RUSTFS_OBS_LOG_ROTATION_TIME` 和 `RUSTFS_OBS_LOG_KEEP_FILES` 调整轮换。 - **URL**（包含 `://`）：日志发送到远程端点。 设置 `RUSTFS_OBS_ENDPOINT` 并启用日志导出后，日志还会通过 OTLP 导出；参考栈将其路由到 Loki，以便从 Grafana 查询。 ```bash title="Example: file logs plus OTLP export" -RUSTFS_OBS_LOG_DIRECTORY=/var/log/rustfs -RUSTFS_OBS_LOGGER_LEVEL=info +RUSTFS_ADDRESS=":9000" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" RUSTFS_OBS_ENDPOINT=http://otel-collector:4318 ``` \ No newline at end of file diff --git a/content/zh/operations/upgrade/container/index.md b/content/zh/operations/upgrade/container/index.md index c26059e8..d0ea376f 100644 --- a/content/zh/operations/upgrade/container/index.md +++ b/content/zh/operations/upgrade/container/index.md @@ -50,8 +50,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs: \ /data ``` @@ -85,8 +88,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs: \ /data ``` diff --git a/content/zh/troubleshooting/driver.md b/content/zh/troubleshooting/driver.md index 4a0d6c93..b0fa2c85 100644 --- a/content/zh/troubleshooting/driver.md +++ b/content/zh/troubleshooting/driver.md @@ -118,7 +118,7 @@ RustFS 在已知挂载点检测到新格式化的磁盘后，后台扫描器会 journalctl -u rustfs -f # Or view the log files under the directory set by RUSTFS_OBS_LOG_DIRECTORY -tail -f /var/logs/rustfs/rustfs.log +tail -f /var/log/rustfs/rustfs.log ``` 你也可以打开 RustFS 控制台，检查受影响节点的磁盘状态。