How to
How to add password for a file/folder?
Add a meta record.
How to reverse proxy with sub directory?
An example of using nginx to reverse proxy to https://nn.ci/alist:
- Normal installation
- Set site_url to
https://nn.ci/alist
or just/alist
then restart alist - Add a reverse proxy record in nginx
location /alist/ {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Range $http_range;
proxy_set_header If-Range $http_if_range;
proxy_redirect off;
proxy_pass http://127.0.0.1:5244/alist/;
# the max size of file to upload
client_max_body_size 20000m;
}
How to get password if i forget it?
If you are the owner of the site, you can get the admin's info by run ./alist admin
in the terminal.
Otherwise you can ask the owner to reset the password.
Tips
You need to stop alist server first if the version of your alist is v3.9.0 or later as this pr: https://github.com/alist-org/alist/pull/3074
Lower than v3.25.0
./alist admin
Higher than v3.25.0
Versions above 3.25.0 change the password to an encrypted hash value, and the password cannot be calculated directly. If the password is forgotten, it can only be re-randomly generated
or manually set
# Randomly generate a password
./alist admin random
# Manually set a password, `NEW_PASSWORD` refers to the password you need to set
./alist admin set NEW_PASSWORD
How to modify the listening port
Refer to config
How to upgrade
Except for the incompatible version marked in the changelog, you can directly replace the binary file to upgrade.
For docker user, just remove the old container and pull the new image then run it.
How to allow guest to upload files
Add a meta record, and open write
field.
powered_by Alist
at the bottom?
How to remove According to our open source license:
Permissions of this strongest copyleft license are conditioned on making available complete source code of licensed works and modifications, which include larger works using a licensed work, under the same license. Copyright and license notices must be preserved. Contributors provide an express grant of patent rights. When a modified version is used to provide a service over a network, the complete source code of the modified version must be made available.
When adding a 189Cloud storage: the device ID does not exist, and a secondary device verification is required
It may be that the risk detection system has been triggered. Please changing the password, then, add it again.
When adding Tianyi cloud disk client storage: prompt need img validate code: verification code
- Click Edit, write the verification code you just saw into the configuration and click Save
- Click Edit and turn on the Do not use OCR button
- Or build it yourself Ocr interface
- 189 Cloud Driver has been replaced with sliding verification code because web login has been replaced.No longer supports OCR and manual input, if the verification code needs to be used, please use the addition of
Cookie to log in
or use the189 Cloud PC
Driver, Note_that_it_is_189_Cloud_driver_is_not_189_Cloud_PC
TLS handshake timeout? / read: connection reset by peer? / dns lookup failed? / connect: connection refused / Client.Timeout exceeded while awaiting headers? / no such host?
For network problems such as these, please troubleshoot and solve them yourself.Don't create any issues for this.
How to add epub reading
Background --> Settings --> Preview --> Iframe preview, written behind the PDF
/*The comma below is also oh, don’t copy this comment, start copying from the second line*/
,
"epub": {
"EPUB.js":"/static/epub.js/viewer.html?url=$e_url"
}
Version 3.7.x and higher already support ".epub" reading
But you need to add it manually (because the database has already been created, it is not good to overwrite it for you, and you will make mistakes)
If it is the first installation and startup (version 3.7.x and higher), no need to add it manually
If the secondary directory reverse generation is set, please add the corresponding prefix in site_url, and then restart AList to take effect
How to quickly locate bugs
If you find a bug, but the log.log
log is not detailed, you can try to add the --debug
parameter to start
It is recommended to clear the log file /log/log.log
in the AList directory before starting with the --debug
parameter, so that developers can quickly locate problems later
Warning
When using the --debug
parameter to start, there will be some sensitive data such as account password, refresh token
, etc., so if you need to desensitize before sending it to others
- Windows:
alist.exe server --debug
- Linux:
./alist server --debug
- Mac: Temporarily unknown, maybe it is started with the
--debug
parameter - Docker:
docker exec -it alist ./alist server --debug
How to stop the relevant logs after startup? Ctrl+c
can stop the program (or simply close the program directly)