X Tutup
Skip to content

Commit f42aa5a

Browse files
ncwncw
committed
Version v1.73.0
1 parent 40f2e84 commit f42aa5a

34 files changed

+10820
-7399
lines changed

‎MANUAL.html‎

Lines changed: 3237 additions & 2929 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎MANUAL.md‎

Lines changed: 1780 additions & 446 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎MANUAL.txt‎

Lines changed: 1824 additions & 585 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎bin/make_manual.py‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@
2323
"gui.md",
2424
"rc.md",
2525
"overview.md",
26+
"tiers.md",
2627
"flags.md",
2728
"docker.md",
2829
"bisync.md",
@@ -43,7 +44,7 @@
4344
"compress.md",
4445
"combine.md",
4546
"doi.md",
46-
"drime.md"
47+
"drime.md",
4748
"dropbox.md",
4849
"filefabric.md",
4950
"filelu.md",
@@ -143,7 +144,7 @@ def read_doc(doc):
143144
contents = fd.read()
144145
parts = contents.split("---\n", 2)
145146
if len(parts) != 3:
146-
raise ValueError("Couldn't find --- markers: found %d parts" % len(parts))
147+
raise ValueError(f"{doc}: Couldn't find --- markers: found {len(parts)} parts")
147148
contents = parts[2].strip()+"\n\n"
148149
# Remove icons
149150
contents = re.sub(r'<i class="fa.*?</i>\s*', "", contents)

‎docs/content/azureblob.md‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -451,6 +451,20 @@ Properties:
451451
- Type: string
452452
- Required: false
453453

454+
#### --azureblob-connection-string
455+
456+
Storage Connection String.
457+
458+
Connection string for the storage. Leave blank if using other auth methods.
459+
460+
461+
Properties:
462+
463+
- Config: connection_string
464+
- Env Var: RCLONE_AZUREBLOB_CONNECTION_STRING
465+
- Type: string
466+
- Required: false
467+
454468
#### --azureblob-tenant
455469

456470
ID of the service principal's tenant. Also called its directory ID.
@@ -1060,6 +1074,24 @@ Properties:
10601074
- Type: string
10611075
- Required: false
10621076

1077+
### Metadata
1078+
1079+
User metadata is stored as x-ms-meta- keys. Azure metadata keys are case insensitive and are always returned in lower case.
1080+
1081+
Here are the possible system metadata items for the azureblob backend.
1082+
1083+
| Name | Help | Type | Example | Read Only |
1084+
|------|------|------|---------|-----------|
1085+
| cache-control | Cache-Control header | string | no-cache | N |
1086+
| content-disposition | Content-Disposition header | string | inline | N |
1087+
| content-encoding | Content-Encoding header | string | gzip | N |
1088+
| content-language | Content-Language header | string | en-US | N |
1089+
| content-type | Content-Type header | string | text/plain | N |
1090+
| mtime | Time of last modification, read from rclone metadata | RFC 3339 | 2006-01-02T15:04:05.999999999Z07:00 | N |
1091+
| tier | Tier of the object | string | Hot | **Y** |
1092+
1093+
See the [metadata](/docs/#metadata) docs for more info.
1094+
10631095
<!-- autogenerated options stop -->
10641096

10651097
### Custom upload headers

‎docs/content/azurefiles.md‎

Lines changed: 55 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -359,7 +359,7 @@ Azure Storage Account Name.
359359

360360
Set this to the Azure Storage Account Name in use.
361361

362-
Leave blank to use SAS URL or connection string, otherwise it needs to be set.
362+
Leave blank to use SAS URL or Emulator, otherwise it needs to be set.
363363

364364
If this is blank and if env_auth is set it will be read from the
365365
environment variable `AZURE_STORAGE_ACCOUNT_NAME` if possible.
@@ -372,25 +372,11 @@ Properties:
372372
- Type: string
373373
- Required: false
374374

375-
#### --azurefiles-share-name
376-
377-
Azure Files Share Name.
378-
379-
This is required and is the name of the share to access.
380-
381-
382-
Properties:
383-
384-
- Config: share_name
385-
- Env Var: RCLONE_AZUREFILES_SHARE_NAME
386-
- Type: string
387-
- Required: false
388-
389375
#### --azurefiles-env-auth
390376

391377
Read credentials from runtime (environment variables, CLI or MSI).
392378

393-
See the [authentication docs](/azurefiles#authentication) for full info.
379+
See the [authentication docs](/azureblob#authentication) for full info.
394380

395381
Properties:
396382

@@ -403,7 +389,7 @@ Properties:
403389

404390
Storage Account Shared Key.
405391

406-
Leave blank to use SAS URL or connection string.
392+
Leave blank to use SAS URL or Emulator.
407393

408394
Properties:
409395

@@ -414,9 +400,9 @@ Properties:
414400

415401
#### --azurefiles-sas-url
416402

417-
SAS URL.
403+
SAS URL for container level access only.
418404

419-
Leave blank if using account/key or connection string.
405+
Leave blank if using account/key or Emulator.
420406

421407
Properties:
422408

@@ -427,7 +413,10 @@ Properties:
427413

428414
#### --azurefiles-connection-string
429415

430-
Azure Files Connection String.
416+
Storage Connection String.
417+
418+
Connection string for the storage. Leave blank if using other auth methods.
419+
431420

432421
Properties:
433422

@@ -519,6 +508,20 @@ Properties:
519508
- Type: string
520509
- Required: false
521510

511+
#### --azurefiles-share-name
512+
513+
Azure Files Share Name.
514+
515+
This is required and is the name of the share to access.
516+
517+
518+
Properties:
519+
520+
- Config: share_name
521+
- Env Var: RCLONE_AZUREFILES_SHARE_NAME
522+
- Type: string
523+
- Required: false
524+
522525
### Advanced options
523526

524527
Here are the Advanced options specific to azurefiles (Microsoft Azure Files).
@@ -581,13 +584,11 @@ Path to file containing credentials for use with a service principal.
581584
Leave blank normally. Needed only if you want to use a service principal instead of interactive login.
582585

583586
$ az ad sp create-for-rbac --name "<name>" \
584-
--role "Storage Files Data Owner" \
587+
--role "Storage Blob Data Owner" \
585588
--scopes "/subscriptions/<subscription>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account>/blobServices/default/containers/<container>" \
586589
> azure-principal.json
587590

588-
See ["Create an Azure service principal"](https://docs.microsoft.com/en-us/cli/azure/create-an-azure-service-principal-azure-cli) and ["Assign an Azure role for access to files data"](https://docs.microsoft.com/en-us/azure/storage/common/storage-auth-aad-rbac-cli) pages for more details.
589-
590-
**NB** this section needs updating for Azure Files - pull requests appreciated!
591+
See ["Create an Azure service principal"](https://docs.microsoft.com/en-us/cli/azure/create-an-azure-service-principal-azure-cli) and ["Assign an Azure role for access to blob data"](https://docs.microsoft.com/en-us/azure/storage/common/storage-auth-aad-rbac-cli) pages for more details.
591592

592593
It may be more convenient to put the credentials directly into the
593594
rclone config file under the `client_id`, `tenant` and `client_secret`
@@ -601,6 +602,28 @@ Properties:
601602
- Type: string
602603
- Required: false
603604

605+
#### --azurefiles-disable-instance-discovery
606+
607+
Skip requesting Microsoft Entra instance metadata
608+
609+
This should be set true only by applications authenticating in
610+
disconnected clouds, or private clouds such as Azure Stack.
611+
612+
It determines whether rclone requests Microsoft Entra instance
613+
metadata from `https://login.microsoft.com/` before
614+
authenticating.
615+
616+
Setting this to true will skip this request, making you responsible
617+
for ensuring the configured authority is valid and trustworthy.
618+
619+
620+
Properties:
621+
622+
- Config: disable_instance_discovery
623+
- Env Var: RCLONE_AZUREFILES_DISABLE_INSTANCE_DISCOVERY
624+
- Type: bool
625+
- Default: false
626+
604627
#### --azurefiles-use-msi
605628

606629
Use a managed service identity to authenticate (only works in Azure).
@@ -660,32 +683,29 @@ Properties:
660683
- Type: string
661684
- Required: false
662685

663-
#### --azurefiles-disable-instance-discovery
686+
#### --azurefiles-use-emulator
664687

665-
Skip requesting Microsoft Entra instance metadata
666-
This should be set true only by applications authenticating in
667-
disconnected clouds, or private clouds such as Azure Stack.
668-
It determines whether rclone requests Microsoft Entra instance
669-
metadata from `https://login.microsoft.com/` before
670-
authenticating.
671-
Setting this to true will skip this request, making you responsible
672-
for ensuring the configured authority is valid and trustworthy.
688+
Uses local storage emulator if provided as 'true'.
673689

690+
Leave blank if using real azure storage endpoint.
674691

675692
Properties:
676693

677-
- Config: disable_instance_discovery
678-
- Env Var: RCLONE_AZUREFILES_DISABLE_INSTANCE_DISCOVERY
694+
- Config: use_emulator
695+
- Env Var: RCLONE_AZUREFILES_USE_EMULATOR
679696
- Type: bool
680697
- Default: false
681698

682699
#### --azurefiles-use-az
683700

684701
Use Azure CLI tool az for authentication
702+
685703
Set to use the [Azure CLI tool az](https://learn.microsoft.com/en-us/cli/azure/)
686704
as the sole means of authentication.
705+
687706
Setting this can be useful if you wish to use the az CLI on a host with
688707
a System Managed Identity that you do not want to use.
708+
689709
Don't set env_auth at the same time.
690710

691711

‎docs/content/bisync.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1049,7 +1049,11 @@ The following backends have known issues that need more investigation:
10491049
<!--- start list_failures - DO NOT EDIT THIS SECTION - use make commanddocs --->
10501050
- `TestDropbox` (`dropbox`)
10511051
- [`TestBisyncRemoteRemote/normalization`](https://pub.rclone.org/integration-tests/current/dropbox-cmd.bisync-TestDropbox-1.txt)
1052-
- Updated: 2025-11-21-010037
1052+
- `TestSeafile` (`seafile`)
1053+
- [`TestBisyncLocalRemote/volatile`](https://pub.rclone.org/integration-tests/current/seafile-cmd.bisync-TestSeafile-1.txt)
1054+
- `TestSeafileV6` (`seafile`)
1055+
- [`TestBisyncLocalRemote/volatile`](https://pub.rclone.org/integration-tests/current/seafile-cmd.bisync-TestSeafileV6-1.txt)
1056+
- Updated: 2026-01-30-010015
10531057
<!--- end list_failures - DO NOT EDIT THIS SECTION - use make commanddocs --->
10541058

10551059
The following backends either have not been tested recently or have known issues
@@ -1058,6 +1062,7 @@ that are deemed unfixable for the time being:
10581062
<!--- start list_ignores - DO NOT EDIT THIS SECTION - use make commanddocs --->
10591063
- `TestArchive` (`archive`)
10601064
- `TestCache` (`cache`)
1065+
- `TestDrime` (`drime`)
10611066
- `TestFileLu` (`filelu`)
10621067
- `TestFilesCom` (`filescom`)
10631068
- `TestImageKit` (`imagekit`)

‎docs/content/changelog.md‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,64 @@ description: "Rclone Changelog"
66

77
# Changelog
88

9+
## v1.73.0 - 2026-01-30
10+
11+
[See commits](https://github.com/rclone/rclone/compare/v1.72.0...v1.73.0)
12+
13+
- New backends
14+
- [Shade](/shade/) (jhasse-shade)
15+
- [Drime](/drime/) (dougal)
16+
- [Filen](/filen/) (Enduriel)
17+
- [Internxt](/internxt/) (jzunigax2)
18+
- New S3 providers
19+
- [Bizfly Cloud Simple Storage](/s3/#bizflycloud) (vupn0712)
20+
- New Features
21+
- docs: Add [Support Tiers](/tiers/) to the documentation (Nick Craig-Wood)
22+
- rc: Add [operations/hashsumfile](/rc/#operations-hashsumfile) to sum a single file only (Nick Craig-Wood)
23+
- serve webdav: Implement download directory as Zip (Leo)
24+
- Bug Fixes
25+
- fs: fix bwlimit: correct reporting (Mikel Olasagasti Uranga)
26+
- log: fix systemd adding extra newline (dougal)
27+
- docs: fixes (albertony, darkdragon-001, Duncan Smart, hyusap, Marc-Philip, Nick Craig-Wood, vicerace, vyv03354, yuval-cloudinary, yy)
28+
- serve s3: Make errors in `--s3-auth-key` fatal (Nick Craig-Wood)
29+
- Mount
30+
- Fix OpenBSD mount support. (Nick Owens)
31+
- Azure Blob
32+
- Add metadata and tags support across upload and copy paths (Cliff Frey)
33+
- Factor the common auth into a library (Nick Craig-Wood)
34+
- Azurefiles
35+
- Factor the common auth into a library (Nick Craig-Wood)
36+
- B2
37+
- Support authentication with new bucket restricted application keys (DianaNites)
38+
- Drive
39+
- Add `--drive-metadata-force-expansive-access` flag (Nick Craig-Wood)
40+
- Fix crash when trying to creating shortcut to a Google doc (Nick Craig-Wood)
41+
- FTP
42+
- Add http proxy authentication support (Nicolas Dessart)
43+
- Mega
44+
- Reverts TLS workaround (necaran)
45+
- Memory
46+
- Add `--memory-discard` flag for speed testing (Nick Craig-Wood)
47+
- OneDrive
48+
- Fix cancelling multipart upload (Nick Craig-Wood)
49+
- Fix setting modification time on directories for OneDrive Personal (Nick Craig-Wood)
50+
- Fix OneDrive Personal no longer supports description (Nick Craig-Wood)
51+
- Fix require sign in for OneDrive Personal (Nick Craig-Wood)
52+
- Fix permissions on OneDrive Personal (Nick Craig-Wood)
53+
- Oracle Object Storage
54+
- Eliminate unnecessary heap allocation (Qingwei Li)
55+
- Pcloud
56+
- Add support for `ChangeNotify` to enable real-time updates in mount (masrlinu)
57+
- Protondrive
58+
- Update to use forks of upstream modules to unblock development (Nick Craig-Wood)
59+
- S3
60+
- Add ability to specify an IAM role for cross-account interaction (Vladislav Tropnikov)
61+
- Linode: updated endpoints to use ISO 3166-1 alpha-2 standard (jbagwell-akamai)
62+
- Fix Copy ignoring storage class (vupn0712)
63+
- SFTP
64+
- Add http proxy authentication support (Nicolas Dessart)
65+
- Eliminate unnecessary heap allocation (Qingwei Li)
66+
967
## v1.72.1 - 2025-12-10
1068

1169
[See commits](https://github.com/rclone/rclone/compare/v1.72.0...v1.72.1)

0 commit comments

Comments
 (0)
X Tutup