মূল কনটেন্টে যান
Localtonet Localtonet ড্যাশবোর্ড

এই পেজ এখনো বাংলা ভাষায় নেই। ইংরেজিতে দেখানো হচ্ছে।

Share a folder with a File Server tunnel

এই পাতার সহায়তা
এই পেজে 11 সেকশন
  1. Before you start
  2. Choose a type
  3. Create the tunnel
  4. Open the File Server page
  5. Fill in the form
  6. Add the people who may sign in
  7. Start the tunnel
  8. Folder path rules
  9. Custom domain
  10. Manage Permissions
  11. Basic Authentication
  12. Settings
  13. Examples
  14. Share a Windows folder in the browser
  15. Connect with an SFTP client
  16. Use a WebDAV client
  17. Troubleshooting
  18. 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.

TypePublic addressHow a visitor connects
Defaulthttps://<ADDRESS>Opens the address in a browser and signs in to a web file manager with a user you created under Manage Permissions.
SFTPsftp://<ADDRESS>:<PORT>Connects with any SFTP client, using the address, the port and a username and password from Manage Permissions.
WebDAVhttps://<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 #

  1. Open the File Server page #

    Open My Tunnels › File Server and expand Create File Server Tunnel.

  2. Fill in the form #

    FieldWhat to enter
    URL typeRandom subdomain, Custom subdomain or Custom domain. Custom subdomains and custom domains need Balance.
    Device tokenThe token of the device that holds the folder.
    Server regionChoose a region close to your device for lower latency.
    Default / SFTP / WebDAVThe file server type. Default is selected at first.
    Subdomain and DomainShown for Custom subdomain: the name you want and the domain it belongs to.
    DomainShown for Custom domain: your own domain name.
    Folder pathAn absolute folder path on the device running Localtonet. See the rules below.

    Select Create tunnel. The tunnel appears under Your tunnels.

  3. 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.

  4. 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.

DevicePath
WindowsA full path with the drive letter, for example C:\Users\Work or C:\Shared.
LinuxA full path from the root, for example /root, /usr/share or /home/user/shared.
MobileThe 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.

  1. Select Add User. For an SFTP tunnel without users the dialog already opens with an empty user.
  2. Enter a Username and a Password.
  3. Tick the roles the user needs.
  4. Select Save Changes.
FieldWhat it does
UsernameThe sign-in name. Each username can be used only once in a tunnel. A card without a username is not saved.
PasswordThe sign-in password. The eye button shows or hides it while you type.
Restricted PathOptional. 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/.
AdminFull access. Ticking it ticks every other role; clearing any other role clears it.
ReadView and download.
CreateUpload files and create folders. In the Default file manager it also allows renaming.
DeleteDelete files and folders.
ShareCreate 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:

SettingWhat it doesMore
Load BalanceDistribute 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 NoteSave a private note to help you identify or document this tunnel.Settings reference
IP RestrictionControl which client IP addresses can access this tunnel.Access control
Expiration DateChoose an expiry date for this tunnel.Limits and expiration
Speed LimitsLimit upload and download speeds for this tunnel.Limits and expiration
Outbound PortChoose a fixed outbound port for the Localtonet app's server connection.Ports
Bandwidth LimitSet a data transfer limit for this tunnel.Limits and expiration
Bandwidth TrafficView the tunnel's uploaded and downloaded traffic over time.Logs and inspection
Bandwidth UsageClear resets the tunnel's recorded bandwidth usage.Limits and expiration
Request LogInspect requests recorded for this tunnel.Logs and inspection
Activity LogReview 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 #

  1. Create a tunnel with Random subdomain, type Default and the folder path C:\Shared.
  2. Under Manage, add a user with the Read role for people who should only download, or Admin for yourself.
  3. 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:

Terminal
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:

Terminal
curl -u <USERNAME> -T report.pdf https://<ADDRESS>/report.pdf

Troubleshooting #

"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.

সাপোর্ট