Update Apps
This commit is contained in:
pooneyy
@@ -1,44 +1,46 @@
|
||||
# Heimdall
|
||||
# 海姆达尔
|
||||
|
||||
[](https://heimdall.site)
|
||||
|
||||
[](https://discord.gg/CCjHKn4)
|
||||
[](https://hub.docker.com/r/linuxserver/heimdall/)
|
||||
[](https://www.firsttimersonly.com/)
|
||||
[](https://www.paypal.me/heimdall)
|
||||
[](https://discord.gg/CCjHKn4) [](https://hub.docker.com/r/linuxserver/heimdall/) [](https://www.firsttimersonly.com/) [](https://www.paypal.me/heimdall)
|
||||
|
||||
___
|
||||
* * *
|
||||
|
||||
Visit the website - https://heimdall.site
|
||||
___
|
||||
访问网站 - [https://heimdall.site](https://heimdall.site)
|
||||
|
||||
## About
|
||||
As the name suggests Heimdall Application Dashboard is a dashboard for all your web applications. It doesn't need to be limited to applications though, you can add links to anything you like.
|
||||
* * *
|
||||
|
||||
Heimdall is an elegant solution to organise all your web applications. It’s dedicated to this purpose so you won’t lose your links in a sea of bookmarks.
|
||||
## 关于
|
||||
|
||||
Why not use it as your browser start page? It even has the ability to include a search bar using either Google, Bing or DuckDuckGo.
|
||||
正如其名，海姆达尔应用仪表板是您所有网络应用的仪表板。不过，它并不仅限于应用，您还可以添加您喜欢的任何链接。
|
||||
|
||||
海姆达尔是一个优雅的解决方案，用于组织您所有的网络应用程序。它专注于这个目的，所以您不会在书签的海洋中丢失链接。
|
||||
|
||||
为什么不将其用作您的浏览器起始页呢？它甚至能够包含使用谷歌、必应或 DuckDuckGo 的搜索栏。
|
||||
|
||||
|
||||
|
||||
## Video
|
||||
If you want to see a quick video of it in use, go to https://youtu.be/GXnnMAxPzMc
|
||||
## 视频
|
||||
|
||||
## Supported applications
|
||||
You can use the app to link to any site or application, but Foundation apps will auto fill in the icon for the app and supply a default color for the tile. In addition Enhanced apps allow you provide details to an apps API, allowing you to view live stats directly on the dashboad. For example, the NZBGet and Sabnzbd Enhanced apps will display the queue size and download speed while something is downloading.
|
||||
如果您想快速查看其使用视频，请访问 [https://youtu.be/GXnnMAxPzMc](https://youtu.be/GXnnMAxPzMc)
|
||||
|
||||
Supported applications are recognized by the title of the application as entered in the title field when adding an application. For example, to add a link to pfSense, begin by typing "p" in the title field and then select "pfSense" from the list of supported applications.
|
||||
## 支持的应用程序
|
||||
|
||||
您可以使用该应用链接到任何网站或应用程序，但基础应用程序将自动填充应用程序的图标并为磁贴提供默认颜色。此外，增强型应用程序允许您向应用程序的 API 提供详细信息，让您可以直接在仪表板上查看实时统计数据。例如，NZBGet 和 Sabnzbd 增强型应用程序将在下载时显示队列大小和下载速度。
|
||||
|
||||
支持的应用程序通过在添加应用程序时在标题字段中输入的应用程序标题来识别。例如，要添加 pfSense 的链接，请在标题字段中输入“p”，然后从支持的应用程序列表中选择“pfSense”。
|
||||
|
||||
[](https://apps.heimdall.site/applications/enhanced)
|
||||
|
||||
[](https://apps.heimdall.site/applications/foundation)
|
||||
|
||||
## Installing
|
||||
Apart from the Laravel 8 dependencies, namely PHP >= 7.4.32, BCMath PHP Extension, INTL PHP Extension, Ctype PHP Extension, Fileinfo PHP extension, JSON PHP Extension, Mbstring PHP Extension, OpenSSL PHP Extension, PDO PHP Extension, Tokenizer PHP Extension, XML PHP Extension, the only other thing Heimdall needs is sqlite support and zip support (php-zip).
|
||||
## 安装
|
||||
|
||||
If you find you can't change the background make sure `php_fileinfo` is enabled in your php.ini. I believe it should be by default, but one user came across the issue on a windows system.
|
||||
除了 Laravel 8 的依赖项，即 PHP >= 7.4.32、BCMath PHP 扩展、INTL PHP 扩展、Ctype PHP 扩展、Fileinfo PHP 扩展、JSON PHP 扩展、Mbstring PHP 扩展、OpenSSL PHP 扩展、PDO PHP 扩展、Tokenizer PHP 扩展、XML PHP 扩展之外，Heimdall 还需要 sqlite 支持和 zip 支持（php-zip）。
|
||||
|
||||
Installation is as simple as cloning the repository somewhere, or downloading and extracting the zip/tar and pointing your httpd document root to the `/public` folder then creating the .env file and generating an encryption key (this is all taken care of for you with the docker).
|
||||
如果你发现无法更改背景，请确保在 php.ini 中启用了 `php_fileinfo`。我相信它应该是默认启用的，但一位用户在 Windows 系统上遇到了这个问题。
|
||||
|
||||
安装非常简单，只需将仓库克隆到某个位置，或者下载并解压 zip/tar 文件，然后将 httpd 文档根目录指向 `/public` 文件夹，然后创建.env 文件并生成加密密钥（所有这些操作都由 docker 为你处理）。
|
||||
|
||||
```
|
||||
cd /path/to/heimdall
|
||||
@@ -46,83 +48,91 @@ cp .env.example .env
|
||||
php artisan key:generate
|
||||
```
|
||||
|
||||
For simple testing you could just go to the folder and type `php artisan serve`
|
||||
对于简单测试，你只需进入文件夹，输入 `php artisan serve`
|
||||
|
||||
There is also a multi-arch Docker which supports x86-64, armhf and arm64, instructions on how to use them at
|
||||
也存在支持 x86-64、armhf 和 arm64 的多架构 Docker，如何在
|
||||
|
||||
- https://hub.docker.com/r/linuxserver/heimdall/
|
||||
* [https://hub.docker.com/r/linuxserver/heimdall/](https://hub.docker.com/r/linuxserver/heimdall/)
|
||||
|
||||
## Updating
|
||||
To update your instance, simply clone this repository or download the zip/tar file with the new version and copy it over the old installation.
|
||||
## 更新
|
||||
|
||||
## Search Providers
|
||||
v2.3.0 added the ability for users to customise the search options.
|
||||
要更新您的实例，只需克隆此仓库或下载包含新版本的 zip/tar 文件，并将其复制到旧安装上。
|
||||
|
||||
Options are stored in `/storage/app/searchproviders.yaml` (`/config/www/searchproviders.yaml` on docker installs), feel free to rearrange the options, add new ones, delete ones you don't use, etc.
|
||||
## 搜索提供商
|
||||
|
||||
Consider contributing to https://github.com/linuxserver/Heimdall/discussions/categories/search-providers to help others add new ones.
|
||||
v2.3.0 版本增加了用户自定义搜索选项的功能。
|
||||
|
||||
The item at the top of the list `Tiles` allows you to search for apps on your dashboard by name, helpful when you have lots of icons.
|
||||
选项存储在 `/storage/app/searchproviders.yaml` （在 Docker 安装中为 `/config/www/searchproviders.yaml` ），您可以随意调整选项顺序，添加新的选项，删除不使用的选项等。
|
||||
|
||||
## New background image not being set
|
||||
If you are using the docker image or a default php install you may find images over 2MB wont get set as the background image, you just need to change the `upload_max_filesize` in the php.ini.
|
||||
请考虑向 [https://github.com/linuxserver/Heimdall/discussions/categories/search-providers](https://github.com/linuxserver/Heimdall/discussions/categories/search-providers) 做出贡献，以帮助他人添加新的选项。
|
||||
|
||||
If you are using the linuxserver.io docker image simply edit `/path/to/config/php/php-local.ini` and add `upload_max_filesize = 30M` to the end.
|
||||
列表顶部的项目`瓷砖`允许您通过名称在仪表板上搜索应用程序，当您有很多图标时非常有用。
|
||||
|
||||
## Docker and enhanced apps
|
||||
If you are running the docker and the EnhancedApps you are using are also in dockers, you may need to use the docker networking addresses to communicate with them.
|
||||
## 新背景图片未设置
|
||||
|
||||
You can do this by using `http(s)://docker_name:port` in the config section. Instead of the name you can use the internal docker ip, this usually starts with `172.`
|
||||
如果您正在使用 docker 镜像或默认的 php 安装，您可能会发现超过 2MB 的图片无法设置为背景图片，您只需更改 php.ini 中的 `upload_max_filesize`。
|
||||
|
||||
## Languages
|
||||
The app has been translated into several languages; however, the quality of the translations could do with work. If you would like to improve them, or help with other translations, they are stored in `/resources/lang/`.
|
||||
如果您正在使用 linuxserver.io docker 镜像，只需编辑 `/path/to/config/php/php-local.ini` ，并在末尾添加 `upload_max_filesize = 30M`。
|
||||
|
||||
To create a new language translation, make a new folder with the ISO 3166-1 alpha-2 code as the name, copy `app.php` from `/resources/lang/en/app.php` into your new folder and replace the English strings.
|
||||
## Docker 和增强应用
|
||||
|
||||
When you are finished, create a pull request.
|
||||
如果您正在运行 docker，并且您使用的 EnhancedApps 也位于 docker 中，您可能需要使用 docker 网络地址来与它们通信。
|
||||
|
||||
Currently added languages are
|
||||
您可以通过在配置部分使用 `http(s)://docker_name:port` 来实现这一点。代替名称，您可以使用内部 Docker IP，这通常以 `172.` 开头。
|
||||
|
||||
- Breton
|
||||
- Chinese
|
||||
- Danish
|
||||
- Dutch
|
||||
- English
|
||||
- Finnish
|
||||
- French
|
||||
- German
|
||||
- Greek
|
||||
- Hungarian
|
||||
- Italian
|
||||
- Japanese
|
||||
- Korean
|
||||
- Lombard
|
||||
- Norwegian
|
||||
- Polish
|
||||
- Portuguese
|
||||
- Russian
|
||||
- Slovenian
|
||||
- Spanish
|
||||
- Swedish
|
||||
- Turkish
|
||||
## 语言
|
||||
|
||||
## Web Server Configuration
|
||||
该应用已翻译成多种语言；然而，翻译质量有待提高。如果您想改进它们或帮助进行其他翻译，它们存储在 `/resources/lang/`。
|
||||
|
||||
要创建一种新的语言翻译，创建一个以 ISO 3166-1 alpha-2 代码命名的文件夹，将 `app.php` 从 `/resources/lang/en/app.php` 复制到您的文件夹中，并替换英文字符串。
|
||||
|
||||
完成之后，创建一个 pull request。
|
||||
|
||||
目前添加的语言有
|
||||
|
||||
* 布列塔尼语
|
||||
* 中文
|
||||
* 丹麦语
|
||||
* 荷兰语
|
||||
* 英语
|
||||
* 芬兰语
|
||||
* 法语
|
||||
* 德语
|
||||
* 希腊语
|
||||
* 匈牙利语
|
||||
* 意大利语
|
||||
* 日语
|
||||
* 韩语
|
||||
* 伦巴第
|
||||
* 挪威语
|
||||
* 波兰语
|
||||
* 葡萄牙语
|
||||
* 俄语
|
||||
* 斯洛文尼亚语
|
||||
* 西班牙语
|
||||
* 瑞典语
|
||||
* 土耳其
|
||||
|
||||
## Web 服务器配置
|
||||
|
||||
### Apache
|
||||
A `.htaccess` file ships with the app, however, a lot of apache installations disallow `.htaccess` files by default.
|
||||
You will notice this due to some links not working like `/settings`.
|
||||
In addition mod-rewrite needs to be enabled if it isn't already.
|
||||
|
||||
#### Fixes & work around options
|
||||
##### - Apache global allow .htaccess
|
||||
Find the `AllowOverride None` line in your apache configuration and change this to `AllowOverride All`
|
||||
应用程序附带一个 `.htaccess` 文件，然而，许多 Apache 安装默认禁止 `.htaccess` 文件。您会注意到一些链接无法正常工作，如 `/settings`。此外，如果尚未启用，还需要启用 mod-rewrite 模块。
|
||||
|
||||
##### - Apache vhost configuration allow .htaccess
|
||||
In the apache vhost configuration in the `<Directory />` block add `AllowOverride All`
|
||||
#### 修复和绕过选项
|
||||
|
||||
##### \- Apache 全局允许 .htaccess
|
||||
|
||||
在您的 Apache 配置中找到 `AllowOverride None` 行，并将其更改为 `AllowOverride All`
|
||||
|
||||
##### \- Apache vhost 配置允许 .htaccess
|
||||
|
||||
在 apache vhost 配置中的 `<Directory />` 块中添加 `AllowOverride All`
|
||||
|
||||
##### \- 在 apache 配置中添加.htaccess 内容
|
||||
|
||||
您可以将完整的 `.htaccess` 添加到您的 apache 配置中，这样您就不需要允许 `.htaccess` 文件。您甚至可以在将其插入到 apache 配置中时缩短 `.htaccess` 的内容：
|
||||
|
||||
##### - Add .htaccess content in apache configuration
|
||||
You can add the full `.htaccess` into your apache configuration, this way you do not need to allow `.htaccess` files.
|
||||
You can even shorten the content of the `.htaccess` when inserting it into the apache configuration to:
|
||||
```
|
||||
Options +FollowSymLinks
|
||||
RewriteEngine On
|
||||
@@ -131,33 +141,36 @@ RewriteCond %{REQUEST_FILENAME} !-d
|
||||
RewriteCond %{REQUEST_FILENAME} !-f
|
||||
RewriteRule ^ index.php [L]
|
||||
```
|
||||
#### More info
|
||||
More info about `AllowOverride` can be found here:
|
||||
https://httpd.apache.org/docs/2.4/mod/core.html#allowoverride
|
||||
|
||||
#### 更多信息
|
||||
|
||||
更多关于 `AllowOverride` 的信息可以在这里找到： [https://httpd.apache.org/docs/2.4/mod/core.html#allowoverride](https://httpd.apache.org/docs/2.4/mod/core.html#allowoverride)
|
||||
|
||||
### Nginx
|
||||
If you are using Nginx, the following directive in your site configuration will direct all requests to the `index.php` front controller:
|
||||
|
||||
如果您正在使用 Nginx，您的站点配置中的以下指令将把所有请求导向 `index.php` 前端控制器：
|
||||
|
||||
```
|
||||
location / {
|
||||
try_files $uri $uri/ /index.php?$query_string;
|
||||
}
|
||||
```
|
||||
Someone was using the same nginx setup to both run this and reverse proxy Plex, Plex is served from `/web` so their location was interfering with the `/webfonts`.
|
||||
|
||||
Therefore, if your fonts aren't showing because you have a location for `/web`, add the following
|
||||
有人使用相同的 nginx 配置来运行这个和反向代理 Plex，Plex 是从 `/web` 提供的，所以它们的位置干扰了 `/webfonts`。
|
||||
|
||||
因此，如果你的字体没有显示，因为你有一个位于 `/web` 的位置，请添加以下内容
|
||||
|
||||
```
|
||||
location /webfonts {
|
||||
try_files $uri $uri/;
|
||||
}
|
||||
```
|
||||
If there are any other locations which might interfere with any of the folders in the `/public` folder, you might have to do the same for those as well, but it's a super fringe case.
|
||||
|
||||
### Reverse proxy
|
||||
If you'd like to reverse proxy this app, we recommend using our letsencrypt/nginx docker image: [SWAG - Secure Web Application Gateway](https://hub.docker.com/r/linuxserver/swag)
|
||||
You can either reverse proxy from the root location, or from a subdomain (subfolder method is currently not supported). For HTTPS proxy, make sure you use the HTTPS port of Heimdall webserver, otherwise some links may break. You can add security through `.htpasswd`
|
||||
如果有任何其他位置可能会干扰到 `/public` 文件夹中的任何文件夹，您可能也需要对它们做同样的处理，但这只是一个极边缘的情况。
|
||||
|
||||
### 反向代理
|
||||
|
||||
如果您想反向代理此应用，我们建议使用我们的 letsencrypt/nginx docker 镜像：\[SWAG - Secure Web Application Gateway\](#0) 您可以从根位置或子域名（目前不支持子文件夹方法）进行反向代理。对于 HTTPS 代理，请确保您使用 Heimdall web 服务器的 HTTPS 端口，否则某些链接可能会中断。您可以通过 `.htpasswd` 添加安全性。
|
||||
|
||||
```
|
||||
location / {
|
||||
@@ -169,44 +182,50 @@ location / {
|
||||
}
|
||||
```
|
||||
|
||||
### Self-signed certificates and local CAs
|
||||
Per default Heimdall uses the standard certificate bundle file (`ca-certificates.crt`) to verify HTTPS sites and will ignore additional certificates placed in `/etc/ssl/certs`. If you wish to use enhanced apps with HTTPS sites that use a self-signed certificate or certs signed with your own local CA, you can override the default bundle:
|
||||
### 自签名证书和本地 CA
|
||||
|
||||
- Create a unified certificate `.pem` file that contains all CAs and certificates that Heimdall has to verify. For example, if you use both LetsEncrypt and a local CA for your internal apps, concatenate the LetsEncrypt intermediate CA (export via browser) and your local CA `cert.pem` (or any number of self-signed certs) into one `heimdall.pem` file.
|
||||
- Place the `heimdall.pem` into the container (if you use Docker), for example by placing it in the path that you mapped to `/config`. Make sure that the Heimdall user has read access (`chmod a+r`).
|
||||
- Set the `openssl.cafile` setting in `/config/php/php-local.ini` to your cert bundle:
|
||||
默认情况下，Heimdall 使用标准证书捆绑文件（`ca-certificates.crt`）来验证 HTTPS 站点，并将忽略放置在 `/etc/ssl/certs` 中的附加证书。如果您希望使用带有自签名证书或使用您自己的本地 CA 签名的证书的增强型 HTTPS 站点应用，您可以覆盖默认捆绑：
|
||||
|
||||
* 创建一个包含所有 CA 和证书的统一证书文件 `.pem`，以便 Heimdall 进行验证。例如，如果您同时使用 Let's Encrypt 和本地 CA 为您的内部应用，将 Let's Encrypt 的中间 CA（通过浏览器导出）和您的本地 CA `cert.pem`（或任何数量的自签名证书）合并到一个 `heimdall.pem` 文件中。
|
||||
* 将 `heimdall.pem` 放入容器中（如果您使用 Docker），例如将其放置在映射到 `/config` 的路径中。确保 Heimdall 用户有读取权限（`chmod a+r`）。
|
||||
* 在 `/config/php/php-local.ini` 中设置 `openssl.cafile` 设置为您证书包：
|
||||
|
||||
```
|
||||
# /config/php/php-local.ini
|
||||
openssl.cafile = /config/heimdall.pem
|
||||
```
|
||||
|
||||
Restart the container and the enhanced apps should now be able to access your local HTTP websites. This configuration will survive updating or recreating the Heimdall container.
|
||||
重启容器，增强后的应用现在应该能够访问您的本地 HTTP 网站。此配置将在更新或重新创建 Heimdall 容器时保持不变。
|
||||
|
||||
## Running offline
|
||||
The apps list is hosted on github, you have a couple of options if you want to run without a connection to the outside world:
|
||||
1) Clone the repository and host it yourself, look at the .github actions file to see how to generate the apps list.
|
||||
2) Download the apps list and store it as a json accessible to heimdall named `list.json`
|
||||
## 离线运行
|
||||
|
||||
With both options all you need to do is add the following to your `.env`
|
||||
`APP_SOURCE=http://localhost/` Where `http://localhost/` is the path to the apps list without the name of the file, so if your file is stored at `https://heimdall.local/list.json` you would put `APP_SOURCE=https://heimdall.local/`
|
||||
应用程序列表托管在 GitHub 上，如果您想在无外部连接的情况下运行，有以下几种选择：
|
||||
|
||||
## Support
|
||||
https://discord.gg/CCjHKn4 or through GitHub issues
|
||||
1. 克隆仓库并自行托管，查看.gitignore 文件了解如何生成应用程序列表。
|
||||
2. 下载应用程序列表并将其存储为名为 `list.json` 的可供 heimdall 访问的 json 文件。
|
||||
|
||||
## Donate
|
||||
If you would like to show your appreciation, feel free to use the link below.
|
||||
只需将以下内容添加到您的 `.env``APP_SOURCE=http://localhost/`，其中 `http://localhost/` 是不带文件名的应用列表路径，所以如果您的文件存储在 `https://heimdall.local/list.json` ，您应该输入 `APP_SOURCE=https://heimdall.local/`
|
||||
|
||||
## 支持
|
||||
|
||||
[https://discord.gg/CCjHKn4](https://discord.gg/CCjHKn4) 或通过 GitHub issues
|
||||
|
||||
## 捐赠
|
||||
|
||||
如果您想表达感谢，请随意使用下面的链接。
|
||||
|
||||
[](https://www.paypal.me/heimdall)
|
||||
|
||||
## Credits
|
||||
- PHP Framework - [Laravel](https://laravel.com/)
|
||||
- Icons - [FontAwesome 5](https://fontawesome.com/)
|
||||
- JavaScript - [jQuery](https://jquery.com/)
|
||||
- Colour picker - [Huebee](http://huebee.buzz/)
|
||||
- Background image - [pexels](https://www.pexels.com)
|
||||
- Trianglify library - [Trianglify](https://github.com/qrohlf/trianglify)
|
||||
- Everyone at Linuxserver.io that has helped with the app and let's not forget IronicBadger for the following question that started it all:
|
||||
## 致谢
|
||||
|
||||
* PHP 框架 - [Laravel](https://laravel.com/)
|
||||
* 图标 - [FontAwesome 5](https://fontawesome.com/)
|
||||
* JavaScript - [jQuery](https://jquery.com/)
|
||||
* 颜色选择器 - [Huebee](http://huebee.buzz/)
|
||||
* 背景图片 - [pexels](https://www.pexels.com)
|
||||
* 三角形图案库 - [Trianglify](https://github.com/qrohlf/trianglify)
|
||||
* Linuxserver.io 上的每个人都帮助了这款应用，还有不要忘了 IronicBadger，正是以下问题开启了这一切：
|
||||
|
||||
```
|
||||
you know, i would love something like this landing page for all my servers apps
|
||||
that gives me the ability to pin favourites
|
||||
@@ -214,6 +233,6 @@ and / or search
|
||||
@Stark @Kode do either of you think you'd be able to rustle something like this up ?
|
||||
```
|
||||
|
||||
## License
|
||||
## 许可证
|
||||
|
||||
This app is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).
|
||||
此应用是开源软件，许可协议为 [MIT 许可协议](https://opensource.org/licenses/MIT) 。
|
||||
Reference in New Issue
Block a user