Other FAQs

How to create a public download directory?#

You can use nginx fancyindex to create a read-only download link:

sudo su -
cd /etc/nginx/apps
touch $username.public.conf
cat > $username.public.conf << EOF
location /$username.public {
alias /home/$username/public;
include /etc/nginx/snippets/fancyindex.conf;
location ~* \.php$ {
}
}
EOF
nginx -s reload

please change the $username as well as alias /home/$username/public . You will be able to access your folder via https://YOURDOMAIN/$username.public

Why my torrents being rechecked after restart the BT client?#

BT clients record resume data periodically. When these data didn't save into its database when closing the client, it will cause the recheck action to ensure data integrity. When you need to shut down the client (as well as halt your server), please pause all the active torrents and wait about 5 min.

How to connect my application WebUI with IP:Port?#

The most applications in QuickBox Lite are using Nginx reverse proxy to protect them. If you want to access your application directly, you have to modify the application configuration.

Why it fails to add a bunch of torrents to BT Client via WebUI?#

QuickBox Lite has a limit in reverse proxy. The upload file size is limited to 32MB per session. It may crash or failed when the limit is exceeded. You can modify Nginx configure to resolve: enlarge client_max_body_size in /etc/nginx/snippets/proxy.conf and restart Nginx.

How to add a Cloudflare CDN?#

You need to buy a domain and create a Cloudflare account, add the domain to the Cloudflare dashboard. Make sure there is an A Record for your server. The Proxy status should be Proxied. You may find it redirect loop after enabling Cloudflare, which caused by the Nginx config problem. You have 2 Solutions:

  • Fix it with the following code:
domain=YOUR DOMAIN
cat > /etc/nginx/sites-enabled/default <<NGC
server {
listen 80 default_server;
listen [::]:80 default_server;
server_name ${domain};
location /.well-known {
alias /srv/.well-known;
allow all;
default_type "text/plain";
autoindex on;
}
client_max_body_size 40M;
server_tokens off;
root /srv/;
index index.html index.php index.htm;
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/$sock.sock;
fastcgi_param SCRIPT_FILENAME \$document_root\$fastcgi_script_name;
}
include /etc/nginx/apps/*;
location ~ /\.ht {
deny all;
}
location /fancyindex {
}
}
# SSL configuration
server {
listen 443 ssl http2 default_server;
listen [::]:443 ssl http2 default_server;
server_name ${domain};
ssl_certificate /etc/ssl/certs/ssl-cert-snakeoil.pem;
ssl_certificate_key /etc/ssl/private/ssl-cert-snakeoil.key;
include snippets/ssl-params.conf;
client_max_body_size 40M;
server_tokens off;
root /srv/;
index index.html index.php index.htm;
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/$sock.sock;
fastcgi_param SCRIPT_FILENAME \$document_root\$fastcgi_script_name;
}
include /etc/nginx/apps/*;
location ~ /\.ht {
deny all;
}
location /fancyindex {
}
}
NGC
nginx -s reload

After clearing the browser cache, the problem can be solved in most cases. For security, you can open SSL/TLS -> Always Use HTTPS in the Cloudflare Control Panel.

  • Change Settings on Cloudflare:

This problem appears at SSL/TLS encryption mode is Flexible, the Cloudflare will visit your server via Port 80, which will receive a redirect signal to 443 by nginx. So just change the SSL/TLS encryption mode to Full to use the 443 by default will solve it.

How to install QuickBox with a proxy?#

Sometimes you will get installation failed caused by network problem (e.g. unstable CDN of software). You can solve it by applying a proxy. Here's a method(proxychains-ng):

  • compile and install the latest proxychains-ng(needs root privilege):

    cd /tmp
    git clone https://github.com/rofl0r/proxychains-ng
    cd proxychains-ng
    ./configure --prefix=/usr --sysconfdir=/etc
    make
    make install
    make install-config
  • configure the proxychains-ng:

    vim /etc/proxychains.conf
    quiet_mode
    proxy_dns
    [ProxyList]
    socks5 127.0.0.1 6666
    http 127.0.0.1 6666
  • apply proxychains-ng while installing:

    proxychains4 -q bash /etc/QuickBox/setup.sh # for QuickBox installation
    proxychains4 -q box install novnc # for software installation

How to upgrade / downgrade a application?#

The easiest way is to run box update APP. File Browser, Flexget, Netdata, qBittorrent, rTorrent, ruTorrent are currently supported for upgrading, and rTorrent, Deluge, qBittorrent are supported for specific versions. qBittorrent and rTorrent can be downgraded.