15308555518/ seafile-admin-docs
1
0
Fork 0
mirror of https://github.com/haiwen/seafile-admin-docs.git synced 2025-12-26 02:32:50 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Deployed 96820fb5 to 13.0 with MkDocs 1.6.1 and mike 2.1.3

This commit is contained in:
ci-bot 2025-10-25 09:56:17 +00:00
parent f02febf7c2
commit 0fdd0621cc
3 changed files with 95 additions and 87 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
13.0/search/search_index.json
View File

File diff suppressed because one or more lines are too long

2
13.0/setup/use_other_reverse_proxy/index.html
View File

@ -4689,7 +4689,7 @@ location /onlyofficeds/ {
</div>
<div class="tabbed-block">
<div class="highlight"><pre><span></span><code>location /thumbnail {
proxy_pass http://127.0.0.1:8084/;
proxy_pass http://127.0.0.1:8084;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;

178
13.0/setup_binary/installation/index.html
View File

@ -1807,6 +1807,15 @@
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#create-the-env-file-in-conf-directory" class="md-nav__link">
<span class="md-ellipsis">
Create the .env file in conf/ directory
</span>
</a>
</li>
<li class="md-nav__item">
@ -1825,15 +1834,6 @@
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#create-the-env-file-in-conf-directory" class="md-nav__link">
<span class="md-ellipsis">
Create the .env file in conf/ directory
</span>
</a>
</li>
</ul>
@ -4610,6 +4610,15 @@
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#create-the-env-file-in-conf-directory" class="md-nav__link">
<span class="md-ellipsis">
Create the .env file in conf/ directory
</span>
</a>
</li>
<li class="md-nav__item">
@ -4628,15 +4637,6 @@
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#create-the-env-file-in-conf-directory" class="md-nav__link">
<span class="md-ellipsis">
Create the .env file in conf/ directory
</span>
</a>
</li>
</ul>
@ -4714,7 +4714,7 @@
<h3 id="installing-and-preparing-the-sql-database">Installing and preparing the SQL database<a class="headerlink" href="#installing-and-preparing-the-sql-database" title="Permanent link">&para;</a></h3>
<p>Seafile supports MySQL and MariaDB. We recommend that you use the preferred SQL database management engine included in the package repositories of your distribution.</p>
<p>You can find step-by-step how-tos for installing MySQL and MariaDB in the <a href="https://www.digitalocean.com/community/tutorials">tutorials on the Digital Ocean website</a>.</p>
<p>Seafile uses the <code>mysql_native_password</code> plugin for authentication. The versions of MySQL and MariaDB installed on CentOS 8, Debian 10, and Ubuntu 20.04 use a different authentication plugin by default. It is therefore required to change to authentication plugin to <code>mysql_native_password</code> for the root user prior to the installation of Seafile. The above mentioned tutorials explain how to do it.</p>
<p>Seafile uses the <code>mysql_native_password</code> plugin for authentication. The versions of MySQL and MariaDB installed on Ubuntu/Debian use a different authentication plugin by default. It is therefore required to change to authentication plugin to <code>mysql_native_password</code> for the root user prior to the installation of Seafile. The above mentioned tutorials explain how to do it.</p>
<h3 id="installing-prerequisites">Installing prerequisites<a class="headerlink" href="#installing-prerequisites" title="Permanent link">&para;</a></h3>
<div class="admonition tip">
<p class="admonition-title">Tip</p>
@ -4722,9 +4722,9 @@
</div>
<ol>
<li>
<p>Install cache server (e.g., <em>Memcached</em>)</p>
<p>Install cache server (e.g., <em>Redis</em>)</p>
<div class="highlight"><pre><span></span><code>sudo<span class="w"> </span>apt-get<span class="w"> </span>update
sudo<span class="w"> </span>apt-get<span class="w"> </span>install<span class="w"> </span>-y<span class="w"> </span>memcached<span class="w"> </span>libmemcached-dev
sudo<span class="w"> </span>apt-get<span class="w"> </span>install<span class="w"> </span>-y<span class="w"> </span>redis-server<span class="w"> </span>libhiredis-dev
</code></pre></div>
</li>
<li>
@ -4836,21 +4836,21 @@ pip3 install --timeout=3600 boto3 oss2 twilio configparser pytz \
</div>
<h3 id="downloading-the-install-package">Downloading the install package<a class="headerlink" href="#downloading-the-install-package" title="Permanent link">&para;</a></h3>
<p>The install packages for Seafile PE are available for download in the the <a href="https://customer.seafile.com">Seafile Customer Center</a>. To access the Customer Center, a user account is necessary. The registration is free.</p>
<p>Beginning with Seafile PE 7.0.17, the Seafile Customer Center provides two install packages for every version (using Seafile PE 12.0.6 as an example):</p>
<p>Beginning with Seafile PE 7.0.17, the Seafile Customer Center provides two install packages for every version (using Seafile PE 13.0.10 as an example):</p>
<ul>
<li><em>seafile-pro-server_12.0.6_x86-64_Ubuntu.tar.gz</em>, compiled in Ubuntu environment</li>
<li><em>seafile-pro-server_13.0.10_x86-64_Ubuntu.tar.gz</em>, compiled in Ubuntu environment</li>
</ul>
<p>The former is suitable for installation on Ubuntu/Debian servers.</p>
<p>Download the install package using wget (replace the x.x.x with the version you wish to download):</p>
<div class="highlight"><pre><span></span><code># Debian/Ubuntu
wget -O &#39;seafile-pro-server_x.x.x_x86-64_Ubuntu.tar.gz&#39; &#39;VERSION_SPECIFIC_LINK_FROM_SEAFILE_CUSTOMER_CENTER&#39;
</code></pre></div>
<p>We use Seafile version 12.0.6 as an example in the remainder of these instructions.</p>
<p>We use Seafile version 13.0.10 as an example in the remainder of these instructions.</p>
<h3 id="uncompressing-the-package">Uncompressing the package<a class="headerlink" href="#uncompressing-the-package" title="Permanent link">&para;</a></h3>
<p>The install package is downloaded as a compressed tarball which needs to be uncompressed.</p>
<p>Uncompress the package using tar:</p>
<div class="highlight"><pre><span></span><code># Debian/Ubuntu
tar xf seafile-pro-server_12.0.6_x86-64_Ubuntu.tar.gz
tar xf seafile-pro-server_13.0.10_x86-64_Ubuntu.tar.gz
</code></pre></div>
<p>Now you have:</p>
<div class="highlight"><pre><span></span><code>$ tree -L 2 /opt/seafile
@ -4862,7 +4862,7 @@ tar xf seafile-pro-server_12.0.6_x86-64_Ubuntu.tar.gz
│   ├── lib
│   ├── lib64 -&gt; lib
│   └── pyvenv.cfg
├── seafile-pro-server-12.0.6
├── seafile-pro-server-13.0.10
│   ├── check_init_admin.py
│   ├── index_op.py
│   ├── migrate-repo.py
@ -4896,14 +4896,14 @@ tar xf seafile-pro-server_12.0.6_x86-64_Ubuntu.tar.gz
│   ├── setup-seafile.sh
│   ├── sql
│   └── upgrade
└── seafile-pro-server_12.0.6_x86-64_Ubuntu.tar.gz
└── seafile-pro-server_13.0.10_x86-64_Ubuntu.tar.gz
</code></pre></div>
<div class="admonition tip">
<p class="admonition-title">Tip</p>
<p>The names of the install packages differ for Seafile CE and Seafile PE. Using Seafile CE and Seafile PE 12.0.6 as an example, the names are as follows:</p>
<p>The names of the install packages differ for Seafile CE and Seafile PE. Using Seafile CE and Seafile PE 13.0.10 as an example, the names are as follows:</p>
<ul>
<li>Seafile CE: <code>seafile-server_12.0.6_x86-86.tar.gz</code>; uncompressing into folder <code>seafile-server-12.0.6</code></li>
<li>Seafile PE: <code>seafile-pro-server_12.0.6_x86-86.tar.gz</code>; uncompressing into folder <code>seafile-pro-server-12.0.6</code></li>
<li>Seafile CE: <code>seafile-server_13.0.10_x86-86.tar.gz</code>; uncompressing into folder <code>seafile-server-13.0.10</code></li>
<li>Seafile PE: <code>seafile-pro-server_13.0.10_x86-86.tar.gz</code>; uncompressing into folder <code>seafile-pro-server-13.0.10</code></li>
</ul>
</div>
<h3 id="setting-up-seafile-pro-databases">Setting up Seafile Pro databases<a class="headerlink" href="#setting-up-seafile-pro-databases" title="Permanent link">&para;</a></h3>
@ -4923,7 +4923,7 @@ tar xf seafile-pro-server_12.0.6_x86-64_Ubuntu.tar.gz
<div class="highlight"><pre><span></span><code><span class="nb">source</span><span class="w"> </span>python-venv/bin/activate
</code></pre></div>
</div>
<div class="highlight"><pre><span></span><code>cd seafile-pro-server-12.0.6
<div class="highlight"><pre><span></span><code>cd seafile-pro-server-13.0.10
./setup-seafile-mysql.sh
</code></pre></div>
<p>Configure your Seafile Server by specifying the following three parameters:</p>
@ -5097,7 +5097,7 @@ GRANT ALL PRIVILEGES ON `seahub_db`.* to `seafile`@localhost;
│   └── pyvenv.cfg
├── seafile-data
│   └── library-template
├── seafile-pro-server-12.0.6
├── seafile-pro-server-13.0.10
│   ├── check_init_admin.py
│   ├── index_op.py
│   ├── migrate-repo.py
@ -5131,62 +5131,12 @@ GRANT ALL PRIVILEGES ON `seahub_db`.* to `seafile`@localhost;
│   ├── setup-seafile.sh
│   ├── sql
│   └── upgrade
├── seafile-pro-server_12.0.6_x86-64_Ubuntu.tar.gz
├── seafile-server-latest -&gt; seafile-pro-server-12.0.6
├── seafile-pro-server_13.0.10_x86-64_Ubuntu.tar.gz
├── seafile-server-latest -&gt; seafile-pro-server-13.0.10
└── seahub-data
└── avatars
</code></pre></div>
<p>The folder <code>seafile-server-latest</code> is a symbolic link to the current Seafile Server folder. When later you upgrade to a new version, the upgrade scripts update this link to point to the latest Seafile Server folder.</p>
<h3 id="setup-memory-cache">Setup Memory Cache<a class="headerlink" href="#setup-memory-cache" title="Permanent link">&para;</a></h3>
<p>Memory cache is mandatory for pro edition. You may use Memcached or Reids as cache server.</p>
<div class="tabbed-set tabbed-alternate" data-tabs="4:2"><input checked="checked" id="__tabbed_4_1" name="__tabbed_4" type="radio" /><input id="__tabbed_4_2" name="__tabbed_4" type="radio" /><div class="tabbed-labels"><label for="__tabbed_4_1">Memcached</label><label for="__tabbed_4_2">Redis</label></div>
<div class="tabbed-content">
<div class="tabbed-block">
<p>Use the following commands to install memcached and corresponding libraies on your system:</p>
<div class="highlight"><pre><span></span><code># on Debian/Ubuntu 18.04+
apt-get install memcached libmemcached-dev -y
pip3 install --timeout=3600 pylibmc django-pylibmc
systemctl enable --now memcached
</code></pre></div>
<p>Add or modify the following configuration to <code>seahub_settings.py</code>:</p>
<div class="highlight"><pre><span></span><code><span class="n">CACHES</span> <span class="o">=</span> <span class="p">{</span>
<span class="s1">&#39;default&#39;</span><span class="p">:</span> <span class="p">{</span>
<span class="s1">&#39;BACKEND&#39;</span><span class="p">:</span> <span class="s1">&#39;django_pylibmc.memcached.PyLibMCCache&#39;</span><span class="p">,</span>
<span class="s1">&#39;LOCATION&#39;</span><span class="p">:</span> <span class="s1">&#39;127.0.0.1:11211&#39;</span><span class="p">,</span>
<span class="p">},</span>
<span class="p">}</span>
</code></pre></div>
<p>Add or modify the following configuration to <code>seafile.conf</code>:</p>
<div class="highlight"><pre><span></span><code>[memcached]
memcached_options = --SERVER=127.0.0.1 --POOL-MIN=10 --POOL-MAX=100
</code></pre></div>
</div>
<div class="tabbed-block">
<div class="admonition success">
<p class="admonition-title">Redis is supported since version 11.0</p>
</div>
<ol>
<li>
<p>Install Redis with package installers in your OS.</p>
</li>
<li>
<p>Refer to <a href="https://docs.djangoproject.com/en/4.2/topics/cache/#redis">Django's documentation about using Redis cache</a> to add Redis configurations to <code>seahub_settings.py</code>.</p>
</li>
<li>
<p>Add or modify the following configuration to <code>seafile.conf</code>:</p>
<div class="highlight"><pre><span></span><code>[redis]
redis_host = 127.0.0.1
redis_port = 6379
max_connections = 100
</code></pre></div>
</li>
</ol>
</div>
</div>
</div>
<h3 id="enabling-httphttps-optional-but-recommended">Enabling HTTP/HTTPS (Optional but Recommended)<a class="headerlink" href="#enabling-httphttps-optional-but-recommended" title="Permanent link">&para;</a></h3>
<p>You need at least setup HTTP to make Seafile's web interface work. This manual provides instructions for enabling HTTP/HTTPS for the two most popular web servers and reverse proxies (e.g., <a href="../https_with_nginx/">Nginx</a>).</p>
<h3 id="create-the-env-file-in-conf-directory">Create the <code>.env</code> file in <code>conf/</code> directory<a class="headerlink" href="#create-the-env-file-in-conf-directory" title="Permanent link">&para;</a></h3>
<div class="highlight"><pre><span></span><code>nano<span class="w"> </span>/opt/seafile/conf/.env
</code></pre></div>
@ -5206,7 +5156,65 @@ max_connections = 100
<span class="nv">SEAFILE_MYSQL_DB_CCNET_DB_NAME</span><span class="o">=</span>ccnet_db
<span class="nv">SEAFILE_MYSQL_DB_SEAFILE_DB_NAME</span><span class="o">=</span>seafile_db
<span class="nv">SEAFILE_MYSQL_DB_SEAHUB_DB_NAME</span><span class="o">=</span>seahub_db
<span class="c1">## Cache</span>
<span class="nv">CACHE_PROVIDER</span><span class="o">=</span>redis<span class="w"> </span><span class="c1"># options: redis (recommend), memcached</span>
<span class="c1">### Redis</span>
<span class="nv">REDIS_HOST</span><span class="o">=</span>redis
<span class="nv">REDIS_PORT</span><span class="o">=</span><span class="m">6379</span>
<span class="nv">REDIS_PASSWORD</span><span class="o">=</span>
<span class="c1">### Memcached</span>
<span class="nv">MEMCACHED_HOST</span><span class="o">=</span>memcached
<span class="nv">MEMCACHED_PORT</span><span class="o">=</span><span class="m">11211</span>
</code></pre></div>
<h3 id="setup-memory-cache">Setup Memory Cache<a class="headerlink" href="#setup-memory-cache" title="Permanent link">&para;</a></h3>
<p>Memory cache is mandatory for pro edition. You may use Memcached or Reids as cache server.</p>
<div class="tabbed-set tabbed-alternate" data-tabs="4:2"><input checked="checked" id="__tabbed_4_1" name="__tabbed_4" type="radio" /><input id="__tabbed_4_2" name="__tabbed_4" type="radio" /><div class="tabbed-labels"><label for="__tabbed_4_1">Memcached</label><label for="__tabbed_4_2">Redis</label></div>
<div class="tabbed-content">
<div class="tabbed-block">
<p>Use the following commands to install memcached and corresponding libraies on your system:</p>
<div class="highlight"><pre><span></span><code># on Debian/Ubuntu 18.04+
apt-get install memcached libmemcached-dev -y
pip3 install --timeout=3600 pylibmc django-pylibmc
systemctl enable --now memcached
</code></pre></div>
<p>Add or modify the following configuration to <code>/opt/seafile/conf/.env</code>:</p>
<div class="highlight"><pre><span></span><code><span class="c1">## Cache</span>
<span class="n">CACHE_PROVIDER</span><span class="o">=</span><span class="n">memcached</span>
<span class="c1">### Memcached</span>
<span class="n">MEMCACHED_HOST</span><span class="o">=</span><span class="n">memcached</span>
<span class="n">MEMCACHED_PORT</span><span class="o">=</span><span class="mi">11211</span>
</code></pre></div>
</div>
<div class="tabbed-block">
<div class="admonition success">
<p class="admonition-title">Redis is supported since version 11.0</p>
</div>
<p>Use the following commands to install redis and corresponding libraies on your system:</p>
<div class="highlight"><pre><span></span><code># on Debian/Ubuntu 18.04+
apt-get install -y redis-server libhiredis-dev
pip3 install redis django-redis
systemctl enable --now redis-server
</code></pre></div>
<p>Add or modify the following configuration to <code>/opt/seafile/conf/.env</code>:</p>
<div class="highlight"><pre><span></span><code><span class="c1">## Cache</span>
<span class="n">CACHE_PROVIDER</span><span class="o">=</span><span class="n">redis</span>
<span class="c1">### Redis</span>
<span class="n">REDIS_HOST</span><span class="o">=</span><span class="n">redis</span>
<span class="n">REDIS_PORT</span><span class="o">=</span><span class="mi">6379</span>
<span class="n">REDIS_PASSWORD</span><span class="o">=</span>
</code></pre></div>
</div>
</div>
</div>
<h3 id="enabling-httphttps-optional-but-recommended">Enabling HTTP/HTTPS (Optional but Recommended)<a class="headerlink" href="#enabling-httphttps-optional-but-recommended" title="Permanent link">&para;</a></h3>
<p>You need at least setup HTTP to make Seafile's web interface work. This manual provides instructions for enabling HTTP/HTTPS for the two most popular web servers and reverse proxies (e.g., <a href="../https_with_nginx/">Nginx</a>).</p>
<h2 id="starting-seafile-server">Starting Seafile Server<a class="headerlink" href="#starting-seafile-server" title="Permanent link">&para;</a></h2>
<p>Run the following commands in <code>/opt/seafile/seafile-server-latest</code>:</p>
<div class="admonition note">
@ -5237,7 +5245,7 @@ Enter the password again:
<p>Seafile uses the indexing server ElasticSearch to enable full text search.</p>
<h3 id="deploying-elasticsearch">Deploying ElasticSearch<a class="headerlink" href="#deploying-elasticsearch" title="Permanent link">&para;</a></h3>
<p>Our recommendation for deploying ElasticSearch is using Docker. Detailed information about installing Docker on various Linux distributions is available at <a href="https://docs.docker.com/engine/install/">Docker Docs</a>.</p>
<p>Seafile PE 9.0 only supports ElasticSearch 7.x. Seafile PE 10.0, 11.0, 12.0 only supports ElasticSearch 8.x.</p>
<p>Seafile PE 9.0 only supports ElasticSearch 7.x. Seafile PE 10.0, 11.0, 12.0, 13.0 only supports ElasticSearch 8.x.</p>
<p>We use ElasticSearch version 8.15.0 as an example in this section. Version 8.15.0 and newer version have been successfully tested with Seafile.</p>
<p>Pull the Docker image:
<div class="highlight"><pre><span></span><code>sudo docker pull elasticsearch:8.15.0