From 65ae3e1e139741bd7bc22a9abadc59527a29bdb6 Mon Sep 17 00:00:00 2001 From: "rick.chan" Date: Sat, 9 Mar 2024 09:38:52 +0800 Subject: [PATCH] =?UTF-8?q?=E5=8F=91=E5=B8=83=E6=96=87=E7=AB=A0=E5=88=B0?= =?UTF-8?q?=20Hugo=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: rick.chan --- .../Applications/Gitea/Gitea_安装和配置.md | 61 ++++++++++++------- .../Part-DB/Part-DB_安装及使用.md | 16 ++++- 2 files changed, 53 insertions(+), 24 deletions(-) diff --git a/Software/Applications/Gitea/Gitea_安装和配置.md b/Software/Applications/Gitea/Gitea_安装和配置.md index 3ed6b94..3a1eb10 100644 --- a/Software/Applications/Gitea/Gitea_安装和配置.md +++ b/Software/Applications/Gitea/Gitea_安装和配置.md @@ -1,12 +1,23 @@ -# Gitea 安装和配置 +--- +layout: post +title: "Gitea 安装和配置" +subtitle: "" +description: "Gitea 是一个类似于 GitHub 的功能强大的代码托管平台。介绍 Gitea 的安装和配置方法。" +excerpt: "介绍 Gitea 的安装和配置方法。" +date: 2024-03-09 09:12:00 +author: "Rick Chan" +tags: ["Applications", "Gitea"] +categories: ["Software"] +published: true +--- ## 1.简介 -Gitea 是一个类似于 GitHub 的代码托管平台，使用 Go 语言开发，只需要一个可执行程序文件即可部署，非常简单易用，且功能丰富。具有版本管理、组织管理、Issues讨论、版本发布等功能。内置维基百科和 SSH 子系统。 +Gitea 是一个类似于 GitHub 的功能强大的代码托管平台，使用 Go 语言开发，只需要一个可执行程序文件即可部署，非常简单易用，且功能丰富。具有版本管理、组织管理、Issues讨论、版本发布等功能。内置维基百科和 SSH 子系统。 ## 2.Gitea 安装 -下载 Gitea 后直接运行，浏览器输入127.0.0.1:3000 来进行初始配置（需要先安装好数据库软件）。 +下载 Gitea 后直接运行，浏览器输入127.0.0.1:3000 来进行初始配置（需要先安装好数据库软件）。 ## 3.配置文件 @@ -20,15 +31,15 @@ Gitea 的配置文件为 \/custom/conf 目录下的 ### 4.1.Windows 服务 -使用 SC 命令创建 Gitea 服务，并自动运行： +使用 SC 命令创建 Gitea 服务，并自动运行： ```bash sc create Gitea start= auto binPath= ""<绝对路径>\gitea.exe" web --config "<绝对路径>\custom\conf\app.ini"" ``` -创建完服务后进入 Windows Services 找到 Gitea 并且点击运行。 +创建完服务后进入 Windows Services 找到 Gitea 并且点击运行。 -如不再需要，同样使用 SC 命令删除服务，删除服务前需先停止该服务。 +如不再需要，同样使用 SC 命令删除服务，删除服务前需先停止该服务。 ```bash sc delete Gitea @@ -36,13 +47,13 @@ sc delete Gitea ### 4.2.Linux 服务 -systemd 服务的开启过程如下，首先创建 gitea.service 文件 +systemd 服务的开启过程如下，首先创建 gitea.service 文件： ```bash sudo vim /etc/systemd/system/gitea.service ``` -并参照以下模板填充该文件 +并参照以下模板填充该文件： ```ini [Unit] @@ -79,14 +90,14 @@ Restart=always WantedBy=multi-user.target ``` -使用如下命令使能并启动 gitea 服务 +使用如下命令使能并启动 gitea 服务： ```bash sudo systemctl enable gitea sudo systemctl start gitea ``` -使用如下命令停止 gitea 服务 +使用如下命令停止 gitea 服务： ```bash sudo systemctl stop gitea @@ -100,7 +111,7 @@ sudo systemctl stop gitea gitea cert --host --ca --duration 87600h ``` -参数说明： +参数说明： | Argument | Description | |----------------------|-----------------------------------------------------------------------------------------------------------| @@ -108,7 +119,7 @@ gitea cert --host --ca --duration 87600h | --duration \ | Duration which the certificate is valid for. Optional. (default: 8760h0m0s) | | --ca | If provided, this cert generates it’s own certificate authority. Optional. | -编辑 app.ini 文件如下： +编辑 app.ini 文件如下： ```ini [server] @@ -119,17 +130,17 @@ CERT_FILE = <绝对路径>/custom/https/cert.pem KEY_FILE = <绝对路径>/custom/https/key.pem ``` -注意，上面 CERT_FILE 和 KEY_FILE 必须使用绝对路径，否则无法正常启动 Gitea 服务。之后重启 Gitea 服务。通过浏览器访问 HTTPS 版本的 Gitea 服务，需要添加浏览器例外才能正常访问。另外客户端使用 git clone 需要关闭 git 的 ssl 认证功能。命令如下： +注意，上面 CERT_FILE 和 KEY_FILE 必须使用绝对路径，否则无法正常启动 Gitea 服务。之后重启 Gitea 服务。通过浏览器访问 HTTPS 版本的 Gitea 服务，需要添加浏览器例外才能正常访问。另外客户端使用 git clone 需要关闭 git 的 ssl 认证功能。命令如下： ```bash git config --global http.sslVerify false ``` -另外 Gitea 还可以使用 Let’s Encrypt 提供的证书，这是 CA 认证证书，有效期为 90 天。Let’s Encrypt 的使用方法见官方手册。 +另外 Gitea 还可以使用 Let’s Encrypt 提供的证书，这是 CA 认证证书，有效期为 90 天。Let’s Encrypt 的使用方法见官方手册。 ## 6.使用内置 SSH -Gitea 有内置 SSH 服务，支持 SSH 格式的 git clone，使能方式为修改 app.ini 文件中的下列内容： +Gitea 有内置 SSH 服务，支持 SSH 格式的 git clone，使能方式为修改 app.ini 文件中的下列内容： ```ini [server] @@ -145,18 +156,26 @@ SSH_LISTEN_PORT = 3022 Gitea 可以通过预先配置好的电子邮件发送服务器发送服务邮件如：通知、消息、注册确认等信息。邮件发送服务器为 smtp 服务器，需要同时提供服务器端口，用户名和密码。 ```ini -[mailer] -ENABLED = true ; Mail server ; Gmail: smtp.gmail.com:587 ; QQ: smtp.qq.com:465 +; 163: smtp.163.com:465 ; Note, if the port ends with "465", SMTPS will be used. Using STARTTLS on port 587 is recommended per RFC 6409. If the server supports STARTTLS it will always be used. -HOST = smtp.sina.com:465 +[mailer] +ENABLED = true +; PROTOCOL: empty: One of "smtp", "smtps", "smtp+starttls", "smtp+unix", "sendmail", "dummy". +PROTOCOL = smtp +SMTP_ADDR = smtp.sina.com +; SMTP_PORT: empty: Mail server port. If no protocol is specified, it will be inferred by this setting. Common ports are +; * 25: insecure SMTP +; * 465: SMTP Secure +; * 587: StartTLS + ; Mail from address, RFC 5322. This can be just an email address, or the `"Name" ` format FROM = user_name@sina.com ; Mailer user name and password USER = user_name@sina.com -; Use PASSWD = `your password` for quoting if you use special characters in the password. +; Use PASSWD = `your password` for quoting if you use special characters in the password. 该字段也可用于指定“设备授权码” PASSWD = user_password ``` @@ -170,7 +189,7 @@ ENABLE_NOTIFY_MAIL = true ## 8.允许通过邮箱进行外部注册 -开启邮件系统后，可以开启邮件注册功能。用户可以自己注册账号，并收到注册确认邮件。通过点击注册确认邮件中的连接，激活新账号。 +开启邮件系统后，可以开启邮件注册功能。用户可以自己注册账号，并收到注册确认邮件。通过点击注册确认邮件中的连接，激活新账号。 ```ini [service] @@ -184,7 +203,7 @@ ALLOW_ONLY_EXTERNAL_REGISTRATION = false ENABLE_CAPTCHA = true ``` -其中，校验码为可选功能，建议开启。 +其中，校验码为可选功能，建议开启。 ## 9.配置文件示例 diff --git a/Software/Applications/Part-DB/Part-DB_安装及使用.md b/Software/Applications/Part-DB/Part-DB_安装及使用.md index 1eaa2f8..8c3931f 100644 --- a/Software/Applications/Part-DB/Part-DB_安装及使用.md +++ b/Software/Applications/Part-DB/Part-DB_安装及使用.md @@ -1,6 +1,17 @@ -# Part-DB 安装及使用 +--- +layout: post +title: "Part-DB 安装及使用" +subtitle: "" +description: "Part-DB 是比较实用的元器件进销存 Web 系统，支持使用电脑摄像头扫码（条码和二维码）。本文介绍 Part-DB 的安装和配置方法。" +excerpt: "介绍 Part-DB 的安装和配置方法。" +date: 2024-03-09 09:19:00 +author: "Rick Chan" +tags: ["Applications", "Part-DB"] +categories: ["Software"] +published: true +--- -Part-DB 是比较实用的元器件进销存 Web 系统，支持实用电脑摄像头扫码（条码和二维码）。 +Part-DB 是比较实用的元器件进销存 Web 系统，支持使用电脑摄像头扫码（条码和二维码）。 ## 1. 安装 @@ -119,4 +130,3 @@ Part-DB 还可以与 KiCAD 等 EDA 结合使用，[官方说明在此](https://d 2. [Part-DB Doc](https://docs.part-db.de/) 3. [Part-DB Demo](https://part-db.herokuapp.com/en/) 4. [Part-DB Docker](https://hub.docker.com/r/jbtronics/part-db1) -