diff --git a/MANUAL.html b/MANUAL.html index 7647bb506..8b39b92c9 100644 --- a/MANUAL.html +++ b/MANUAL.html @@ -233,7 +233,7 @@

rclone(1) User Manual

Nick Craig-Wood

-

Nov 21, 2025

+

Dec 10, 2025

NAME

rclone - manage files on cloud storage

@@ -4531,9 +4531,9 @@ SquareBracket
rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,command=echo"
 // Output: stories/The Quick Brown Fox!.txt
rclone convmv "stories/The Quick Brown Fox!" --name-transform "date=-{YYYYMMDD}"
-// Output: stories/The Quick Brown Fox!-20251121
+// Output: stories/The Quick Brown Fox!-20251210
rclone convmv "stories/The Quick Brown Fox!" --name-transform "date=-{macfriendlytime}"
-// Output: stories/The Quick Brown Fox!-2025-11-21 0505PM
+// Output: stories/The Quick Brown Fox!-2025-12-10 1247PM
rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,regex=[\\.\\w]/ab"
 // Output: ababababababab/ababab ababababab ababababab ababab!abababab

The regex command generally accepts Perl-style regular expressions, @@ -22567,7 +22567,7 @@ split into groups.

--tpslimit float Limit HTTP transactions per second to this --tpslimit-burst int Max burst of transactions for --tpslimit (default 1) --use-cookies Enable session cookiejar - --user-agent string Set the user-agent to a specified string (default "rclone/v1.72.0") + --user-agent string Set the user-agent to a specified string (default "rclone/v1.72.1")

Performance

Flags helpful for increasing performance.

      --buffer-size SizeSuffix   In memory buffer size when reading files for each --transfer (default 16Mi)
@@ -23024,7 +23024,7 @@ split into groups.

--gcs-description string Description of the remote --gcs-directory-markers Upload an empty object with a trailing slash when a new directory is created --gcs-encoding Encoding The encoding for the backend (default Slash,CrLf,InvalidUtf8,Dot) - --gcs-endpoint string Endpoint for the service + --gcs-endpoint string Custom endpoint for the storage API. Leave blank to use the provider default --gcs-env-auth Get GCP IAM credentials from runtime (environment variables or instance meta data if no env vars) --gcs-location string Location for the newly created buckets --gcs-no-check-bucket If set, don't attempt to check the bucket exists or create it @@ -25234,7 +25234,29 @@ investigation:

  • TestBisyncRemoteRemote/normalization
  • -
  • Updated: 2025-11-21-010037 +
  • TestGoFile (gofile) +
  • +
  • TestPcloud (pcloud) +
  • +
  • Updated: 2025-12-10-010012
  • The following backends either have not been tested recently or have @@ -28374,15 +28396,30 @@ centers for low latency.

  • St. Petersburg
  • Provider: Selectel,Servercore
  • -
  • "gis-1" +
  • "ru-3"
      -
    • Moscow
    • -
    • Provider: Servercore
    • +
    • St. Petersburg
    • +
    • Provider: Selectel
  • "ru-7"
    • Moscow
    • -
    • Provider: Servercore
    • +
    • Provider: Selectel,Servercore
    • +
  • +
  • "gis-1" +
      +
    • Moscow
    • +
    • Provider: Selectel,Servercore
    • +
  • +
  • "kz-1" +
      +
    • Kazakhstan
    • +
    • Provider: Selectel
    • +
  • +
  • "uz-2" +
      +
    • Uzbekistan
    • +
    • Provider: Selectel
  • "uz-2"
      @@ -29690,17 +29727,37 @@ AWS,Alibaba,ArvanCloud,Ceph,ChinaMobile,Cloudflare,Cubbit,DigitalOcean,Dreamhost
  • "s3.ru-1.storage.selcloud.ru"
      -
    • Saint Petersburg
    • +
    • St. Petersburg
    • +
    • Provider: Selectel
    • +
  • +
  • "s3.ru-3.storage.selcloud.ru" +
      +
    • St. Petersburg
    • +
    • Provider: Selectel
    • +
  • +
  • "s3.ru-7.storage.selcloud.ru" +
      +
    • Moscow
    • Provider: Selectel,Servercore
  • "s3.gis-1.storage.selcloud.ru"
    • Moscow
    • -
    • Provider: Servercore
    • +
    • Provider: Selectel,Servercore
  • -
  • "s3.ru-7.storage.selcloud.ru" +
  • "s3.kz-1.storage.selcloud.ru"
      -
    • Moscow
    • +
    • Kazakhstan
    • +
    • Provider: Selectel
    • +
  • +
  • "s3.uz-2.storage.selcloud.ru" +
      +
    • Uzbekistan
    • +
    • Provider: Selectel
    • +
  • +
  • "s3.ru-1.storage.selcloud.ru" +
      +
    • Saint Petersburg
    • Provider: Servercore
  • "s3.uz-2.srvstorage.uz" @@ -41496,6 +41553,9 @@ storage options, and sharing capabilities. With support for high storage limits and seamless integration with rclone, FileLu makes managing files in the cloud easy. Its cross-platform file backup services let you upload and back up files from any internet-connected device.

    +

    Note FileLu now has a fully featured S3 backend FileLu S5, an industry standard S3 compatible +object store.

    Configuration

    Here is an example of how to make a remote called filelu. First, run:

    @@ -43418,14 +43478,36 @@ decompressed.

  • Default: false
  • --gcs-endpoint

    -

    Endpoint for the service.

    -

    Leave blank normally.

    +

    Custom endpoint for the storage API. Leave blank to use the provider +default.

    +

    When using a custom endpoint that includes a subpath (e.g. +example.org/custom/endpoint), the subpath will be ignored during upload +operations due to a limitation in the underlying Google API Go client +library. Download and listing operations will work correctly with the +full endpoint path. If you require subpath support for uploads, avoid +using subpaths in your custom endpoint configuration.

    Properties:

    --gcs-encoding

    The encoding for the backend.

    @@ -43670,7 +43752,7 @@ account. It is a ~21 character numerical string. https://www.googleapis.com/auth/drive to grant read/write access to Google Drive specifically. You can also use https://www.googleapis.com/auth/drive.readonly for read -only access. +only access with --drive-scope=drive.readonly.
  • Click "Authorise"
  • 3. Configure rclone, @@ -62593,6 +62675,32 @@ the output.

    Changelog

    +

    v1.72.1 - 2025-12-10

    +

    See +commits

    +

    v1.72.0 - 2025-11-21

    See diff --git a/MANUAL.md b/MANUAL.md index 06bc59a49..ad97613de 100644 --- a/MANUAL.md +++ b/MANUAL.md @@ -1,6 +1,6 @@ % rclone(1) User Manual % Nick Craig-Wood -% Nov 21, 2025 +% Dec 10, 2025 # NAME @@ -5369,12 +5369,12 @@ rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,command=e ```console rclone convmv "stories/The Quick Brown Fox!" --name-transform "date=-{YYYYMMDD}" -// Output: stories/The Quick Brown Fox!-20251121 +// Output: stories/The Quick Brown Fox!-20251210 ``` ```console rclone convmv "stories/The Quick Brown Fox!" --name-transform "date=-{macfriendlytime}" -// Output: stories/The Quick Brown Fox!-2025-11-21 0505PM +// Output: stories/The Quick Brown Fox!-2025-12-10 1247PM ``` ```console @@ -24802,7 +24802,7 @@ Flags for general networking and HTTP stuff. --tpslimit float Limit HTTP transactions per second to this --tpslimit-burst int Max burst of transactions for --tpslimit (default 1) --use-cookies Enable session cookiejar - --user-agent string Set the user-agent to a specified string (default "rclone/v1.72.0") + --user-agent string Set the user-agent to a specified string (default "rclone/v1.72.1") ``` @@ -25319,7 +25319,7 @@ Backend-only flags (these can be set in the config file also). --gcs-description string Description of the remote --gcs-directory-markers Upload an empty object with a trailing slash when a new directory is created --gcs-encoding Encoding The encoding for the backend (default Slash,CrLf,InvalidUtf8,Dot) - --gcs-endpoint string Endpoint for the service + --gcs-endpoint string Custom endpoint for the storage API. Leave blank to use the provider default --gcs-env-auth Get GCP IAM credentials from runtime (environment variables or instance meta data if no env vars) --gcs-location string Location for the newly created buckets --gcs-no-check-bucket If set, don't attempt to check the bucket exists or create it @@ -27514,7 +27514,17 @@ The following backends have known issues that need more investigation: - `TestDropbox` (`dropbox`) - [`TestBisyncRemoteRemote/normalization`](https://pub.rclone.org/integration-tests/current/dropbox-cmd.bisync-TestDropbox-1.txt) -- Updated: 2025-11-21-010037 +- `TestGoFile` (`gofile`) + - [`TestBisyncRemoteLocal/all_changed`](https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt) + - [`TestBisyncRemoteLocal/backupdir`](https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt) + - [`TestBisyncRemoteLocal/basic`](https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt) + - [`TestBisyncRemoteLocal/changes`](https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt) + - [`TestBisyncRemoteLocal/check_access`](https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt) + - [78 more](https://pub.rclone.org/integration-tests/current/) +- `TestPcloud` (`pcloud`) + - [`TestBisyncRemoteRemote/check_access`](https://pub.rclone.org/integration-tests/current/pcloud-cmd.bisync-TestPcloud-1.txt) + - [`TestBisyncRemoteRemote/check_access_filters`](https://pub.rclone.org/integration-tests/current/pcloud-cmd.bisync-TestPcloud-1.txt) +- Updated: 2025-12-10-010012 The following backends either have not been tested recently or have known issues @@ -30343,12 +30353,21 @@ Properties: - "ru-1" - St. Petersburg - Provider: Selectel,Servercore - - "gis-1" - - Moscow - - Provider: Servercore + - "ru-3" + - St. Petersburg + - Provider: Selectel - "ru-7" - Moscow - - Provider: Servercore + - Provider: Selectel,Servercore + - "gis-1" + - Moscow + - Provider: Selectel,Servercore + - "kz-1" + - Kazakhstan + - Provider: Selectel + - "uz-2" + - Uzbekistan + - Provider: Selectel - "uz-2" - Tashkent, Uzbekistan - Provider: Servercore @@ -31140,13 +31159,25 @@ Properties: - SeaweedFS S3 localhost - Provider: SeaweedFS - "s3.ru-1.storage.selcloud.ru" - - Saint Petersburg + - St. Petersburg + - Provider: Selectel + - "s3.ru-3.storage.selcloud.ru" + - St. Petersburg + - Provider: Selectel + - "s3.ru-7.storage.selcloud.ru" + - Moscow - Provider: Selectel,Servercore - "s3.gis-1.storage.selcloud.ru" - Moscow - - Provider: Servercore - - "s3.ru-7.storage.selcloud.ru" - - Moscow + - Provider: Selectel,Servercore + - "s3.kz-1.storage.selcloud.ru" + - Kazakhstan + - Provider: Selectel + - "s3.uz-2.storage.selcloud.ru" + - Uzbekistan + - Provider: Selectel + - "s3.ru-1.storage.selcloud.ru" + - Saint Petersburg - Provider: Servercore - "s3.uz-2.srvstorage.uz" - Tashkent, Uzbekistan @@ -43973,6 +44004,9 @@ managing files in the cloud easy. Its cross-platform file backup services let you upload and back up files from any internet-connected device. +**Note** FileLu now has a fully featured S3 backend [FileLu S5](/s3#filelu-s5), +an industry standard S3 compatible object store. + ## Configuration Here is an example of how to make a remote called `filelu`. First, run: @@ -46071,9 +46105,14 @@ Properties: #### --gcs-endpoint -Endpoint for the service. +Custom endpoint for the storage API. Leave blank to use the provider default. -Leave blank normally. +When using a custom endpoint that includes a subpath (e.g. example.org/custom/endpoint), +the subpath will be ignored during upload operations due to a limitation in the +underlying Google API Go client library. +Download and listing operations will work correctly with the full endpoint path. +If you require subpath support for uploads, avoid using subpaths in your custom +endpoint configuration. Properties: @@ -46081,6 +46120,13 @@ Properties: - Env Var: RCLONE_GCS_ENDPOINT - Type: string - Required: false +- Examples: + - "storage.example.org" + - Specify a custom endpoint + - "storage.example.org:4443" + - Specifying a custom endpoint with port + - "storage.example.org:4443/gcs/api" + - Specifying a subpath, see the note, uploads won't use the custom path! #### --gcs-encoding @@ -46379,7 +46425,7 @@ account key" button. `https://www.googleapis.com/auth/drive` to grant read/write access to Google Drive specifically. You can also use `https://www.googleapis.com/auth/drive.readonly` for read - only access. + only access with `--drive-scope=drive.readonly`. - Click "Authorise" ##### 3. Configure rclone, assuming a new install @@ -66867,6 +66913,22 @@ Options: # Changelog +## v1.72.1 - 2025-12-10 + +[See commits](https://github.com/rclone/rclone/compare/v1.72.0...v1.72.1) + +- Bug Fixes + - build: update to go1.25.5 to fix [CVE-2025-61729](https://pkg.go.dev/vuln/GO-2025-4155) + - doc fixes (Duncan Smart, Nick Craig-Wood) + - configfile: Fix piped config support (Jonas Tingeborn) + - log + - Fix PID not included in JSON log output (Tingsong Xu) + - Fix backtrace not going to the --log-file (Nick Craig-Wood) +- Google Cloud Storage + - Improve endpoint parameter docs (Johannes Rothe) +- S3 + - Add missing regions for Selectel provider (Nick Craig-Wood) + ## v1.72.0 - 2025-11-21 [See commits](https://github.com/rclone/rclone/compare/v1.71.0...v1.72.0) @@ -66887,7 +66949,7 @@ Options: - [rclone test speed](https://rclone.org/commands/rclone_test_speed/): Add command to test a specified remotes speed (dougal) - New Features - backends: many backends have has a paged listing (`ListP`) interface added - - this enables progress when listing large directories and reduced memory usage + - this enables progress when listing large directories and reduced memory usage - build - Bump golang.org/x/crypto from 0.43.0 to 0.45.0 to fix CVE-2025-58181 (dependabot[bot]) - Modernize code and tests (Nick Craig-Wood, russcoss, juejinyuxitu, reddaisyy, dulanting, Oleksandr Redko) diff --git a/MANUAL.txt b/MANUAL.txt index efb8fd646..30feb9ac0 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -1,6 +1,6 @@ rclone(1) User Manual Nick Craig-Wood -Nov 21, 2025 +Dec 10, 2025 NAME @@ -4588,10 +4588,10 @@ Examples: // Output: stories/The Quick Brown Fox!.txt rclone convmv "stories/The Quick Brown Fox!" --name-transform "date=-{YYYYMMDD}" - // Output: stories/The Quick Brown Fox!-20251121 + // Output: stories/The Quick Brown Fox!-20251210 rclone convmv "stories/The Quick Brown Fox!" --name-transform "date=-{macfriendlytime}" - // Output: stories/The Quick Brown Fox!-2025-11-21 0505PM + // Output: stories/The Quick Brown Fox!-2025-12-10 1247PM rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,regex=[\\.\\w]/ab" // Output: ababababababab/ababab ababababab ababababab ababab!abababab @@ -23110,7 +23110,7 @@ Flags for general networking and HTTP stuff. --tpslimit float Limit HTTP transactions per second to this --tpslimit-burst int Max burst of transactions for --tpslimit (default 1) --use-cookies Enable session cookiejar - --user-agent string Set the user-agent to a specified string (default "rclone/v1.72.0") + --user-agent string Set the user-agent to a specified string (default "rclone/v1.72.1") Performance @@ -23597,7 +23597,7 @@ Backend-only flags (these can be set in the config file also). --gcs-description string Description of the remote --gcs-directory-markers Upload an empty object with a trailing slash when a new directory is created --gcs-encoding Encoding The encoding for the backend (default Slash,CrLf,InvalidUtf8,Dot) - --gcs-endpoint string Endpoint for the service + --gcs-endpoint string Custom endpoint for the storage API. Leave blank to use the provider default --gcs-env-auth Get GCP IAM credentials from runtime (environment variables or instance meta data if no env vars) --gcs-location string Location for the newly created buckets --gcs-no-check-bucket If set, don't attempt to check the bucket exists or create it @@ -25734,7 +25734,17 @@ The following backends have known issues that need more investigation: - TestDropbox (dropbox) - TestBisyncRemoteRemote/normalization -- Updated: 2025-11-21-010037 +- TestGoFile (gofile) + - TestBisyncRemoteLocal/all_changed + - TestBisyncRemoteLocal/backupdir + - TestBisyncRemoteLocal/basic + - TestBisyncRemoteLocal/changes + - TestBisyncRemoteLocal/check_access + - 78 more +- TestPcloud (pcloud) + - TestBisyncRemoteRemote/check_access + - TestBisyncRemoteRemote/check_access_filters +- Updated: 2025-12-10-010012 The following backends either have not been tested recently or have known issues that are deemed unfixable for the time being: @@ -28517,12 +28527,21 @@ Properties: - "ru-1" - St. Petersburg - Provider: Selectel,Servercore - - "gis-1" - - Moscow - - Provider: Servercore + - "ru-3" + - St. Petersburg + - Provider: Selectel - "ru-7" - Moscow - - Provider: Servercore + - Provider: Selectel,Servercore + - "gis-1" + - Moscow + - Provider: Selectel,Servercore + - "kz-1" + - Kazakhstan + - Provider: Selectel + - "uz-2" + - Uzbekistan + - Provider: Selectel - "uz-2" - Tashkent, Uzbekistan - Provider: Servercore @@ -29315,13 +29334,25 @@ Properties: - SeaweedFS S3 localhost - Provider: SeaweedFS - "s3.ru-1.storage.selcloud.ru" - - Saint Petersburg + - St. Petersburg + - Provider: Selectel + - "s3.ru-3.storage.selcloud.ru" + - St. Petersburg + - Provider: Selectel + - "s3.ru-7.storage.selcloud.ru" + - Moscow - Provider: Selectel,Servercore - "s3.gis-1.storage.selcloud.ru" - Moscow - - Provider: Servercore - - "s3.ru-7.storage.selcloud.ru" - - Moscow + - Provider: Selectel,Servercore + - "s3.kz-1.storage.selcloud.ru" + - Kazakhstan + - Provider: Selectel + - "s3.uz-2.storage.selcloud.ru" + - Uzbekistan + - Provider: Selectel + - "s3.ru-1.storage.selcloud.ru" + - Saint Petersburg - Provider: Servercore - "s3.uz-2.srvstorage.uz" - Tashkent, Uzbekistan @@ -41720,6 +41751,9 @@ integration with rclone, FileLu makes managing files in the cloud easy. Its cross-platform file backup services let you upload and back up files from any internet-connected device. +Note FileLu now has a fully featured S3 backend FileLu S5, an industry +standard S3 compatible object store. + Configuration Here is an example of how to make a remote called filelu. First, run: @@ -43696,9 +43730,15 @@ Properties: --gcs-endpoint -Endpoint for the service. +Custom endpoint for the storage API. Leave blank to use the provider +default. -Leave blank normally. +When using a custom endpoint that includes a subpath (e.g. +example.org/custom/endpoint), the subpath will be ignored during upload +operations due to a limitation in the underlying Google API Go client +library. Download and listing operations will work correctly with the +full endpoint path. If you require subpath support for uploads, avoid +using subpaths in your custom endpoint configuration. Properties: @@ -43706,6 +43746,14 @@ Properties: - Env Var: RCLONE_GCS_ENDPOINT - Type: string - Required: false +- Examples: + - "storage.example.org" + - Specify a custom endpoint + - "storage.example.org:4443" + - Specifying a custom endpoint with port + - "storage.example.org:4443/gcs/api" + - Specifying a subpath, see the note, uploads won't use the + custom path! --gcs-encoding @@ -43989,7 +44037,8 @@ key" button. - In the next field, "OAuth Scopes", enter https://www.googleapis.com/auth/drive to grant read/write access to Google Drive specifically. You can also use - https://www.googleapis.com/auth/drive.readonly for read only access. + https://www.googleapis.com/auth/drive.readonly for read only access + with --drive-scope=drive.readonly. - Click "Authorise" 3. Configure rclone, assuming a new install @@ -64010,6 +64059,22 @@ Options: Changelog +v1.72.1 - 2025-12-10 + +See commits + +- Bug Fixes + - build: update to go1.25.5 to fix CVE-2025-61729 + - doc fixes (Duncan Smart, Nick Craig-Wood) + - configfile: Fix piped config support (Jonas Tingeborn) + - log + - Fix PID not included in JSON log output (Tingsong Xu) + - Fix backtrace not going to the --log-file (Nick Craig-Wood) +- Google Cloud Storage + - Improve endpoint parameter docs (Johannes Rothe) +- S3 + - Add missing regions for Selectel provider (Nick Craig-Wood) + v1.72.0 - 2025-11-21 See commits diff --git a/docs/content/bisync.md b/docs/content/bisync.md index b3405f9b8..c169c0f4c 100644 --- a/docs/content/bisync.md +++ b/docs/content/bisync.md @@ -1049,7 +1049,17 @@ The following backends have known issues that need more investigation: - `TestDropbox` (`dropbox`) - [`TestBisyncRemoteRemote/normalization`](https://pub.rclone.org/integration-tests/current/dropbox-cmd.bisync-TestDropbox-1.txt) -- Updated: 2025-11-21-010037 +- `TestGoFile` (`gofile`) + - [`TestBisyncRemoteLocal/all_changed`](https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt) + - [`TestBisyncRemoteLocal/backupdir`](https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt) + - [`TestBisyncRemoteLocal/basic`](https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt) + - [`TestBisyncRemoteLocal/changes`](https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt) + - [`TestBisyncRemoteLocal/check_access`](https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt) + - [78 more](https://pub.rclone.org/integration-tests/current/) +- `TestPcloud` (`pcloud`) + - [`TestBisyncRemoteRemote/check_access`](https://pub.rclone.org/integration-tests/current/pcloud-cmd.bisync-TestPcloud-1.txt) + - [`TestBisyncRemoteRemote/check_access_filters`](https://pub.rclone.org/integration-tests/current/pcloud-cmd.bisync-TestPcloud-1.txt) +- Updated: 2025-12-10-010012 The following backends either have not been tested recently or have known issues diff --git a/docs/content/changelog.md b/docs/content/changelog.md index fbba79f41..e90b70c55 100644 --- a/docs/content/changelog.md +++ b/docs/content/changelog.md @@ -6,6 +6,22 @@ description: "Rclone Changelog" # Changelog +## v1.72.1 - 2025-12-10 + +[See commits](https://github.com/rclone/rclone/compare/v1.72.0...v1.72.1) + +- Bug Fixes + - build: update to go1.25.5 to fix [CVE-2025-61729](https://pkg.go.dev/vuln/GO-2025-4155) + - doc fixes (Duncan Smart, Nick Craig-Wood) + - configfile: Fix piped config support (Jonas Tingeborn) + - log + - Fix PID not included in JSON log output (Tingsong Xu) + - Fix backtrace not going to the --log-file (Nick Craig-Wood) +- Google Cloud Storage + - Improve endpoint parameter docs (Johannes Rothe) +- S3 + - Add missing regions for Selectel provider (Nick Craig-Wood) + ## v1.72.0 - 2025-11-21 [See commits](https://github.com/rclone/rclone/compare/v1.71.0...v1.72.0) diff --git a/docs/content/commands/rclone.md b/docs/content/commands/rclone.md index 8fb1e6dd3..df45b6f70 100644 --- a/docs/content/commands/rclone.md +++ b/docs/content/commands/rclone.md @@ -369,7 +369,7 @@ rclone [flags] --gcs-description string Description of the remote --gcs-directory-markers Upload an empty object with a trailing slash when a new directory is created --gcs-encoding Encoding The encoding for the backend (default Slash,CrLf,InvalidUtf8,Dot) - --gcs-endpoint string Endpoint for the service + --gcs-endpoint string Custom endpoint for the storage API. Leave blank to use the provider default --gcs-env-auth Get GCP IAM credentials from runtime (environment variables or instance meta data if no env vars) --gcs-location string Location for the newly created buckets --gcs-no-check-bucket If set, don't attempt to check the bucket exists or create it @@ -1023,7 +1023,7 @@ rclone [flags] --use-json-log Use json log format --use-mmap Use mmap allocator (see docs) --use-server-modtime Use server modified time instead of object metadata - --user-agent string Set the user-agent to a specified string (default "rclone/v1.72.0") + --user-agent string Set the user-agent to a specified string (default "rclone/v1.72.1") -v, --verbose count Print lots more stuff (repeat for more) -V, --version Print the version number --webdav-auth-redirect Preserve authentication on redirect diff --git a/docs/content/commands/rclone_convmv.md b/docs/content/commands/rclone_convmv.md index 04f9026ce..34fd9d599 100644 --- a/docs/content/commands/rclone_convmv.md +++ b/docs/content/commands/rclone_convmv.md @@ -231,12 +231,12 @@ rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,command=e ```console rclone convmv "stories/The Quick Brown Fox!" --name-transform "date=-{YYYYMMDD}" -// Output: stories/The Quick Brown Fox!-20251121 +// Output: stories/The Quick Brown Fox!-20251210 ``` ```console rclone convmv "stories/The Quick Brown Fox!" --name-transform "date=-{macfriendlytime}" -// Output: stories/The Quick Brown Fox!-2025-11-21 0505PM +// Output: stories/The Quick Brown Fox!-2025-12-10 1247PM ``` ```console diff --git a/docs/content/flags.md b/docs/content/flags.md index cc3b11e0d..10d0f29ca 100644 --- a/docs/content/flags.md +++ b/docs/content/flags.md @@ -121,7 +121,7 @@ Flags for general networking and HTTP stuff. --tpslimit float Limit HTTP transactions per second to this --tpslimit-burst int Max burst of transactions for --tpslimit (default 1) --use-cookies Enable session cookiejar - --user-agent string Set the user-agent to a specified string (default "rclone/v1.72.0") + --user-agent string Set the user-agent to a specified string (default "rclone/v1.72.1") ``` @@ -638,7 +638,7 @@ Backend-only flags (these can be set in the config file also). --gcs-description string Description of the remote --gcs-directory-markers Upload an empty object with a trailing slash when a new directory is created --gcs-encoding Encoding The encoding for the backend (default Slash,CrLf,InvalidUtf8,Dot) - --gcs-endpoint string Endpoint for the service + --gcs-endpoint string Custom endpoint for the storage API. Leave blank to use the provider default --gcs-env-auth Get GCP IAM credentials from runtime (environment variables or instance meta data if no env vars) --gcs-location string Location for the newly created buckets --gcs-no-check-bucket If set, don't attempt to check the bucket exists or create it diff --git a/docs/content/googlecloudstorage.md b/docs/content/googlecloudstorage.md index 902ff1f31..3f7c59349 100644 --- a/docs/content/googlecloudstorage.md +++ b/docs/content/googlecloudstorage.md @@ -785,9 +785,14 @@ Properties: #### --gcs-endpoint -Endpoint for the service. +Custom endpoint for the storage API. Leave blank to use the provider default. -Leave blank normally. +When using a custom endpoint that includes a subpath (e.g. example.org/custom/endpoint), +the subpath will be ignored during upload operations due to a limitation in the +underlying Google API Go client library. +Download and listing operations will work correctly with the full endpoint path. +If you require subpath support for uploads, avoid using subpaths in your custom +endpoint configuration. Properties: @@ -795,6 +800,13 @@ Properties: - Env Var: RCLONE_GCS_ENDPOINT - Type: string - Required: false +- Examples: + - "storage.example.org" + - Specify a custom endpoint + - "storage.example.org:4443" + - Specifying a custom endpoint with port + - "storage.example.org:4443/gcs/api" + - Specifying a subpath, see the note, uploads won't use the custom path! #### --gcs-encoding diff --git a/docs/content/s3.md b/docs/content/s3.md index f16779bcc..ac4328386 100644 --- a/docs/content/s3.md +++ b/docs/content/s3.md @@ -1383,12 +1383,21 @@ Properties: - "ru-1" - St. Petersburg - Provider: Selectel,Servercore - - "gis-1" - - Moscow - - Provider: Servercore + - "ru-3" + - St. Petersburg + - Provider: Selectel - "ru-7" - Moscow - - Provider: Servercore + - Provider: Selectel,Servercore + - "gis-1" + - Moscow + - Provider: Selectel,Servercore + - "kz-1" + - Kazakhstan + - Provider: Selectel + - "uz-2" + - Uzbekistan + - Provider: Selectel - "uz-2" - Tashkent, Uzbekistan - Provider: Servercore @@ -2180,13 +2189,25 @@ Properties: - SeaweedFS S3 localhost - Provider: SeaweedFS - "s3.ru-1.storage.selcloud.ru" - - Saint Petersburg + - St. Petersburg + - Provider: Selectel + - "s3.ru-3.storage.selcloud.ru" + - St. Petersburg + - Provider: Selectel + - "s3.ru-7.storage.selcloud.ru" + - Moscow - Provider: Selectel,Servercore - "s3.gis-1.storage.selcloud.ru" - Moscow - - Provider: Servercore - - "s3.ru-7.storage.selcloud.ru" - - Moscow + - Provider: Selectel,Servercore + - "s3.kz-1.storage.selcloud.ru" + - Kazakhstan + - Provider: Selectel + - "s3.uz-2.storage.selcloud.ru" + - Uzbekistan + - Provider: Selectel + - "s3.ru-1.storage.selcloud.ru" + - Saint Petersburg - Provider: Servercore - "s3.uz-2.srvstorage.uz" - Tashkent, Uzbekistan diff --git a/lib/transform/transform.md b/lib/transform/transform.md index bb8d08e0e..9e760ee48 100644 --- a/lib/transform/transform.md +++ b/lib/transform/transform.md @@ -218,12 +218,12 @@ rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,command=e ```console rclone convmv "stories/The Quick Brown Fox!" --name-transform "date=-{YYYYMMDD}" -// Output: stories/The Quick Brown Fox!-20251121 +// Output: stories/The Quick Brown Fox!-20251210 ``` ```console rclone convmv "stories/The Quick Brown Fox!" --name-transform "date=-{macfriendlytime}" -// Output: stories/The Quick Brown Fox!-2025-11-21 0508PM +// Output: stories/The Quick Brown Fox!-2025-12-10 1253PM ``` ```console diff --git a/rclone.1 b/rclone.1 index 2c3a0298b..df9c2cb37 100644 --- a/rclone.1 +++ b/rclone.1 @@ -15,7 +15,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "rclone" "1" "Nov 21, 2025" "User Manual" "" +.TH "rclone" "1" "Dec 10, 2025" "User Manual" "" .hy .SH NAME .PP @@ -6260,14 +6260,14 @@ rclone convmv \[dq]stories/The Quick Brown Fox!.txt\[dq] --name-transform \[dq]a .nf \f[C] rclone convmv \[dq]stories/The Quick Brown Fox!\[dq] --name-transform \[dq]date=-{YYYYMMDD}\[dq] -// Output: stories/The Quick Brown Fox!-20251121 +// Output: stories/The Quick Brown Fox!-20251210 \f[R] .fi .IP .nf \f[C] rclone convmv \[dq]stories/The Quick Brown Fox!\[dq] --name-transform \[dq]date=-{macfriendlytime}\[dq] -// Output: stories/The Quick Brown Fox!-2025-11-21 0505PM +// Output: stories/The Quick Brown Fox!-2025-12-10 1247PM \f[R] .fi .IP @@ -31741,7 +31741,7 @@ Flags for general networking and HTTP stuff. --tpslimit float Limit HTTP transactions per second to this --tpslimit-burst int Max burst of transactions for --tpslimit (default 1) --use-cookies Enable session cookiejar - --user-agent string Set the user-agent to a specified string (default \[dq]rclone/v1.72.0\[dq]) + --user-agent string Set the user-agent to a specified string (default \[dq]rclone/v1.72.1\[dq]) \f[R] .fi .SS Performance @@ -32258,7 +32258,7 @@ Backend-only flags (these can be set in the config file also). --gcs-description string Description of the remote --gcs-directory-markers Upload an empty object with a trailing slash when a new directory is created --gcs-encoding Encoding The encoding for the backend (default Slash,CrLf,InvalidUtf8,Dot) - --gcs-endpoint string Endpoint for the service + --gcs-endpoint string Custom endpoint for the storage API. Leave blank to use the provider default --gcs-env-auth Get GCP IAM credentials from runtime (environment variables or instance meta data if no env vars) --gcs-location string Location for the newly created buckets --gcs-no-check-bucket If set, don\[aq]t attempt to check the bucket exists or create it @@ -34968,7 +34968,31 @@ The following backends have known issues that need more investigation: \f[V]TestBisyncRemoteRemote/normalization\f[R] (https://pub.rclone.org/integration-tests/current/dropbox-cmd.bisync-TestDropbox-1.txt) .RE .IP \[bu] 2 -Updated: 2025-11-21-010037 +\f[V]TestGoFile\f[R] (\f[V]gofile\f[R]) +.RS 2 +.IP \[bu] 2 +\f[V]TestBisyncRemoteLocal/all_changed\f[R] (https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt) +.IP \[bu] 2 +\f[V]TestBisyncRemoteLocal/backupdir\f[R] (https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt) +.IP \[bu] 2 +\f[V]TestBisyncRemoteLocal/basic\f[R] (https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt) +.IP \[bu] 2 +\f[V]TestBisyncRemoteLocal/changes\f[R] (https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt) +.IP \[bu] 2 +\f[V]TestBisyncRemoteLocal/check_access\f[R] (https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt) +.IP \[bu] 2 +78 more (https://pub.rclone.org/integration-tests/current/) +.RE +.IP \[bu] 2 +\f[V]TestPcloud\f[R] (\f[V]pcloud\f[R]) +.RS 2 +.IP \[bu] 2 +\f[V]TestBisyncRemoteRemote/check_access\f[R] (https://pub.rclone.org/integration-tests/current/pcloud-cmd.bisync-TestPcloud-1.txt) +.IP \[bu] 2 +\f[V]TestBisyncRemoteRemote/check_access_filters\f[R] (https://pub.rclone.org/integration-tests/current/pcloud-cmd.bisync-TestPcloud-1.txt) +.RE +.IP \[bu] 2 +Updated: 2025-12-10-010012 .PP The following backends either have not been tested recently or have known issues that are deemed unfixable for the time being: @@ -39263,12 +39287,13 @@ Petersburg Provider: Selectel,Servercore .RE .IP \[bu] 2 -\[dq]gis-1\[dq] +\[dq]ru-3\[dq] .RS 2 .IP \[bu] 2 -Moscow +St. +Petersburg .IP \[bu] 2 -Provider: Servercore +Provider: Selectel .RE .IP \[bu] 2 \[dq]ru-7\[dq] @@ -39276,7 +39301,31 @@ Provider: Servercore .IP \[bu] 2 Moscow .IP \[bu] 2 -Provider: Servercore +Provider: Selectel,Servercore +.RE +.IP \[bu] 2 +\[dq]gis-1\[dq] +.RS 2 +.IP \[bu] 2 +Moscow +.IP \[bu] 2 +Provider: Selectel,Servercore +.RE +.IP \[bu] 2 +\[dq]kz-1\[dq] +.RS 2 +.IP \[bu] 2 +Kazakhstan +.IP \[bu] 2 +Provider: Selectel +.RE +.IP \[bu] 2 +\[dq]uz-2\[dq] +.RS 2 +.IP \[bu] 2 +Uzbekistan +.IP \[bu] 2 +Provider: Selectel .RE .IP \[bu] 2 \[dq]uz-2\[dq] @@ -41371,7 +41420,25 @@ Provider: SeaweedFS \[dq]s3.ru-1.storage.selcloud.ru\[dq] .RS 2 .IP \[bu] 2 -Saint Petersburg +St. +Petersburg +.IP \[bu] 2 +Provider: Selectel +.RE +.IP \[bu] 2 +\[dq]s3.ru-3.storage.selcloud.ru\[dq] +.RS 2 +.IP \[bu] 2 +St. +Petersburg +.IP \[bu] 2 +Provider: Selectel +.RE +.IP \[bu] 2 +\[dq]s3.ru-7.storage.selcloud.ru\[dq] +.RS 2 +.IP \[bu] 2 +Moscow .IP \[bu] 2 Provider: Selectel,Servercore .RE @@ -41381,13 +41448,29 @@ Provider: Selectel,Servercore .IP \[bu] 2 Moscow .IP \[bu] 2 -Provider: Servercore +Provider: Selectel,Servercore .RE .IP \[bu] 2 -\[dq]s3.ru-7.storage.selcloud.ru\[dq] +\[dq]s3.kz-1.storage.selcloud.ru\[dq] .RS 2 .IP \[bu] 2 -Moscow +Kazakhstan +.IP \[bu] 2 +Provider: Selectel +.RE +.IP \[bu] 2 +\[dq]s3.uz-2.storage.selcloud.ru\[dq] +.RS 2 +.IP \[bu] 2 +Uzbekistan +.IP \[bu] 2 +Provider: Selectel +.RE +.IP \[bu] 2 +\[dq]s3.ru-1.storage.selcloud.ru\[dq] +.RS 2 +.IP \[bu] 2 +Saint Petersburg .IP \[bu] 2 Provider: Servercore .RE @@ -57445,6 +57528,9 @@ With support for high storage limits and seamless integration with rclone, FileLu makes managing files in the cloud easy. Its cross-platform file backup services let you upload and back up files from any internet-connected device. +.PP +\f[B]Note\f[R] FileLu now has a fully featured S3 backend FileLu S5, an +industry standard S3 compatible object store. .SS Configuration .PP Here is an example of how to make a remote called \f[V]filelu\f[R]. @@ -60216,9 +60302,17 @@ Type: bool Default: false .SS --gcs-endpoint .PP -Endpoint for the service. +Custom endpoint for the storage API. +Leave blank to use the provider default. .PP -Leave blank normally. +When using a custom endpoint that includes a subpath (e.g. +example.org/custom/endpoint), the subpath will be ignored during upload +operations due to a limitation in the underlying Google API Go client +library. +Download and listing operations will work correctly with the full +endpoint path. +If you require subpath support for uploads, avoid using subpaths in your +custom endpoint configuration. .PP Properties: .IP \[bu] 2 @@ -60229,6 +60323,29 @@ Env Var: RCLONE_GCS_ENDPOINT Type: string .IP \[bu] 2 Required: false +.IP \[bu] 2 +Examples: +.RS 2 +.IP \[bu] 2 +\[dq]storage.example.org\[dq] +.RS 2 +.IP \[bu] 2 +Specify a custom endpoint +.RE +.IP \[bu] 2 +\[dq]storage.example.org:4443\[dq] +.RS 2 +.IP \[bu] 2 +Specifying a custom endpoint with port +.RE +.IP \[bu] 2 +\[dq]storage.example.org:4443/gcs/api\[dq] +.RS 2 +.IP \[bu] 2 +Specifying a subpath, see the note, uploads won\[aq]t use the custom +path! +.RE +.RE .SS --gcs-encoding .PP The encoding for the backend. @@ -60557,7 +60674,7 @@ In the next field, \[dq]OAuth Scopes\[dq], enter access to Google Drive specifically. You can also use \f[V]https://www.googleapis.com/auth/drive.readonly\f[R] for read only -access. +access with \f[V]--drive-scope=drive.readonly\f[R]. .IP \[bu] 2 Click \[dq]Authorise\[dq] .SS 3. Configure rclone, assuming a new install @@ -87115,6 +87232,40 @@ Options: .IP \[bu] 2 \[dq]error\[dq]: Return an error based on option value. .SH Changelog +.SS v1.72.1 - 2025-12-10 +.PP +See commits (https://github.com/rclone/rclone/compare/v1.72.0...v1.72.1) +.IP \[bu] 2 +Bug Fixes +.RS 2 +.IP \[bu] 2 +build: update to go1.25.5 to fix +CVE-2025-61729 (https://pkg.go.dev/vuln/GO-2025-4155) +.IP \[bu] 2 +doc fixes (Duncan Smart, Nick Craig-Wood) +.IP \[bu] 2 +configfile: Fix piped config support (Jonas Tingeborn) +.IP \[bu] 2 +log +.RS 2 +.IP \[bu] 2 +Fix PID not included in JSON log output (Tingsong Xu) +.IP \[bu] 2 +Fix backtrace not going to the --log-file (Nick Craig-Wood) +.RE +.RE +.IP \[bu] 2 +Google Cloud Storage +.RS 2 +.IP \[bu] 2 +Improve endpoint parameter docs (Johannes Rothe) +.RE +.IP \[bu] 2 +S3 +.RS 2 +.IP \[bu] 2 +Add missing regions for Selectel provider (Nick Craig-Wood) +.RE .SS v1.72.0 - 2025-11-21 .PP See commits (https://github.com/rclone/rclone/compare/v1.71.0...v1.72.0)