এই পেজ এখনো বাংলা ভাষায় নেই। ইংরেজিতে দেখানো হচ্ছে।
Share a folder with a File Server tunnel
এই পেজে 11 সেকশন
- Before you start
- Choose a type
- Create the tunnel
- Open the File Server page
- Fill in the form
- Add the people who may sign in
- Start the tunnel
- Folder path rules
- Custom domain
- Manage Permissions
- Basic Authentication
- Settings
- Examples
- Share a Windows folder in the browser
- Connect with an SFTP client
- Use a WebDAV client
- Troubleshooting
- Related pages
A File Server tunnel shares a folder directly from your device, with no cloud upload. Visitors reach it in a browser, over SFTP or over WebDAV, and you decide who may read, upload, delete and share.
Before you start #
- The Localtonet client is running on the device that holds the folder and is connected with an AuthToken. See Quick start.
- You know the full path of the folder you want to share.
- You do not need to install a web, SFTP or WebDAV server. The Localtonet client serves the folder itself.
Choose a type #
You pick the type when you create the tunnel. It decides how people connect.
| Type | Public address | How a visitor connects |
|---|---|---|
| Default | https://<ADDRESS> | Opens the address in a browser and signs in to a web file manager with a user you created under Manage Permissions. |
| SFTP | sftp://<ADDRESS>:<PORT> | Connects with any SFTP client, using the address, the port and a username and password from Manage Permissions. |
| WebDAV | https://<ADDRESS> | Adds the address to a WebDAV client and signs in with a username and password from Manage Permissions. |
The Default file manager lets a signed-in user browse and search the folder, preview, download and upload files, create folders, rename and delete items and create share links, as far as the user's roles allow.
Create the tunnel #
-
Open the File Server page #
Open My Tunnels › File Server and expand Create File Server Tunnel.
-
Fill in the form #
Field What to enter URL type Random subdomain, Custom subdomain or Custom domain. Custom subdomains and custom domains need Balance. Device token The token of the device that holds the folder. Server region Choose a region close to your device for lower latency. Default / SFTP / WebDAV The file server type. Default is selected at first. Subdomain and Domain Shown for Custom subdomain: the name you want and the domain it belongs to. Domain Shown for Custom domain: your own domain name. Folder path An absolute folder path on the device running Localtonet. See the rules below. Select Create tunnel. The tunnel appears under Your tunnels.
-
Add the people who may sign in #
In the Permissions column select Manage, add at least one user and select Save Changes. The dialog is described under Manage Permissions.
-
Start the tunnel #
Select Start. The URL column shows the public address. For an SFTP tunnel it is shown as
sftp://<ADDRESS>:<PORT>; click it to copy it.
Folder path rules #
The path is required. It must be a folder on the device whose token you selected.
| Device | Path |
|---|---|
| Windows | A full path with the drive letter, for example C:\Users\Work or C:\Shared. |
| Linux | A full path from the root, for example /root, /usr/share or /home/user/shared. |
| Mobile | The path you enter is not used. A mobile device always shares the Localtonet app's own directory. |
To change the folder later, select the edit icon next to the path in the Path column, enter the new path and select Submit. A running tunnel is stopped and started again with the new path.
Custom domain #
Before you create a tunnel with Custom domain, update the DNS settings of the domain to include ns1.localtonet.com and ns2.localtonet.com, or create a CNAME record. Custom domains explains both ways.
Manage Permissions #
Select Manage in the Permissions column to open Manage Permissions. The badge in the header shows the type of the tunnel. Each user is a card; select a card to open it.
- Select Add User. For an SFTP tunnel without users the dialog already opens with an empty user.
- Enter a Username and a Password.
- Tick the roles the user needs.
- Select Save Changes.
| Field | What it does |
|---|---|
| Username | The sign-in name. Each username can be used only once in a tunnel. A card without a username is not saved. |
| Password | The sign-in password. The eye button shows or hides it while you type. |
| Restricted Path | Optional. Limits this user to a specific sub-path of the tunnel root, for example /documents. Leave it empty to allow full access. Write folder names separated by /; a value that contains .., a drive letter or : gives the user no access at all. On a Linux device the names are case-sensitive. With Default the user works only inside that folder: browse, search and preview, download, upload, create folders, copy and move, rename, delete and create share links, as far as the roles allow. The other parts of the file manager are not available to this user: the recycle bin, file versions, tags, archives, encrypted and private folders, full-text search, the document viewer, task boards, photo backup, backups, and user and server administration. With SFTP the folder becomes the user's root directory. With WebDAV the user connects to https://<ADDRESS>/<PATH>/, for example https://<ADDRESS>/documents/. |
| Admin | Full access. Ticking it ticks every other role; clearing any other role clears it. |
| Read | View and download. |
| Create | Upload files and create folders. In the Default file manager it also allows renaming. |
| Delete | Delete files and folders. |
| Share | Create share links in the Default file manager. |
The header of each card summarises the roles, or shows No permissions. The bin icon (Remove user) removes the user: their access ends when you select Save Changes. A change to a user's roles also takes effect when you save.
Passwords of Default tunnels. Existing passwords cannot be changed for Default type tunnels; the field shows Cannot be changed. For a forgotten password the dialog advises you to remove the entry and add a new one.
In the Default file manager a new user is asked to choose a new password the first time they sign in.
Basic Authentication #
Default tunnels have one more lock: Basic Authentication? in the tunnel settings requires a username and password to access the tunnel at all, before the file manager's own sign-in page appears. Open Settings for the tunnel, turn on Basic Authentication? and enter the Username and Password. SFTP and WebDAV tunnels do not offer this switch; their users always sign in with the accounts from Manage Permissions.
Settings #
Select the Settings icon of a tunnel to open Tunnel settings. The panel shows the address, the creation date, the token name and the title (select it to rename the tunnel), then these options:
| Setting | What it does | More |
|---|---|---|
| Load Balance | Distribute traffic across devices or use a backup when a target is unavailable. | Load balancing |
| Basic Authentication? | Require a username and password to access this tunnel. Default type only. | Access control |
| Legacy Connect? | Try this if the tunnel cannot connect using the normal connection method. | Settings reference |
| Tunnel Note | Save a private note to help you identify or document this tunnel. | Settings reference |
| IP Restriction | Control which client IP addresses can access this tunnel. | Access control |
| Expiration Date | Choose an expiry date for this tunnel. | Limits and expiration |
| Speed Limits | Limit upload and download speeds for this tunnel. | Limits and expiration |
| Outbound Port | Choose a fixed outbound port for the Localtonet app's server connection. | Ports |
| Bandwidth Limit | Set a data transfer limit for this tunnel. | Limits and expiration |
| Bandwidth Traffic | View the tunnel's uploaded and downloaded traffic over time. | Logs and inspection |
| Bandwidth Usage | Clear resets the tunnel's recorded bandwidth usage. | Limits and expiration |
| Request Log | Inspect requests recorded for this tunnel. | Logs and inspection |
| Activity Log | Review tunnel activity such as starts, stops and setting changes, including permission and path changes. | Logs and inspection |
Examples #
Share a Windows folder in the browser #
- Create a tunnel with Random subdomain, type Default and the folder path
C:\Shared. - Under Manage, add a user with the Read role for people who should only download, or Admin for yourself.
- Start the tunnel and send the address and the sign-in details to the people who need the files.
Connect with an SFTP client #
Create the tunnel with type SFTP, add a user and start the tunnel. Copy the address from the URL column and use its host and port:
sftp -P <PORT> <USERNAME>@<ADDRESS>Graphical SFTP clients take the same four values: host, port, username and password.
Use a WebDAV client #
Create the tunnel with type WebDAV, add a user and start the tunnel. In your WebDAV client enter https://<ADDRESS> as the server address, then the username and password. From a terminal, curl can upload a file the same way:
curl -u <USERNAME> -T report.pdf https://<ADDRESS>/report.pdfTroubleshooting #
"Path is required!"
The Folder path field is empty. Enter the full path of the folder on the device.
"You need to purchase balance to use this feature."
You chose Custom subdomain or Custom domain on an account without Balance. Use Random subdomain, or add Balance. See Plans and Balance.
"Each username can be used only once."
Two cards in Manage Permissions have the same username. Change one of them and save again.
Nobody can sign in
A File Server tunnel has no users until you add them. Open Manage in the Permissions column, add a user with at least the Read role and select Save Changes.
The address does not answer
The tunnel works only while it is started and the Localtonet client of its device is connected. Check the Connection column, then start the client or the tunnel.