OrgLion-Writes
/
NotePublic
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

发布文章到 Hugo。 

Signed-off-by: rick.chan <cy@sina.com>
This commit is contained in:
rick.chan 2024-03-09 09:38:52 +08:00
parent a0389cb28c
commit 65ae3e1e13
2 changed files with 53 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

61
Software/Applications/Gitea/Gitea_安装和配置.md
View File

@ -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 的配置文件为 \<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 <HOST0,HOST1,...> --ca --duration 87600h
```
参数说明：
参数说明：
| Argument | Description |
|----------------------|-----------------------------------------------------------------------------------------------------------|
@ -108,7 +119,7 @@ gitea cert --host <HOST0,HOST1,...> --ca --duration 87600h
| --duration \<value\> | 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" <email@example.com>` 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.配置文件示例

16
Software/Applications/Part-DB/Part-DB_安装及使用.md
View File

@ -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)