sward入门指南(1.2) - Windows环境下安装配置

原创已于 2025-09-28 16:06:34 修改 · 1.2k 阅读

17 ·

CC 4.0 BY-SA版权

文章标签：

#windows #devops #开源免费 #sward #知识库工具 #tiklab

于 2024-12-24 10:51:29 首次发布

sward是一个开源免费企业级知识库管理软件，我们在上篇文章简单介绍过它的功能与优势，今天来介绍一下怎么安装私有部署版本。

1. 安装

下载：下载Windows安装包
安装：双击安装包后，依次点击下一步->安装->完成
启动：sward安装成功后会弹出启动页面，点击启用应用

2. 登录

启动完成后，在浏览器输入http://localhost:9600 使用系统了；若是不在当前安装的电脑中使用，localhost 是安装的服务器的ip；输入账号：admin 密码：123456，登录到项目首页

登录页

首页

3. 自定义配置

sward 私有部署版本可以对数据库，启动端口、登录地址等参数进行配置，自定义配置文件的地址默认在安装目录 --> conf -> application.yaml 目录下

3.1 启动端口

应用启动端口可自定义，默认为9600，可以修改为其他端口；

server:
  port: 9600

属性	值
server.port	系统启动的端口号（可更改）

3.2 数据库

数据库需要在jdbc 和 postgresql 两个部分修改，可以修改数据库地址与端口，账号与密码要改成相应的，数据库端口必须一致

jdbc:
  driverClassName: org.postgresql.Driver
  url: jdbc:postgresql://localhost:9601/tiklab_sward?stringtype=unspecified
  username: postgres
  password: darth2020

postgresql:
  embbed:
    enable: true
  database: tiklab_sward
  db:
    port: 9601
    username: postgres
    password: darth2020
    address: ${DATA_HOME}/postgresql

属性	说明
postgresql.embbed.enable	是否使用内嵌数据库，true:使用 false:不使用。如果配置为false，需要把该文件中jdbc下的数据库连接信息更改为自己的数据库地址，用户名以及密码。
postgresql.database	是否使用内嵌数据库默认连接的数据库，默认为sward_ee如果更改次默认值需要把jdbc下的数据库连接信息更改为新的数据地址。
postgresql.db.port	使用内嵌数据库的启动端口，默认为9601，如果更改需要同时把jdbc.url中的数据库连接地址端口更改。
postgresql.db.username	使用内嵌数据库的用户名，默认为postgres，如果更改需要同时把jdbc.username中的数据库连接地址用户名更改。
postgresql.db.password	使用内嵌数据库的密码，默认为darth2020，如果更改需要同时把jdbc.password中的数据库连接地址密码更改。
postgresql.db.address	使用内嵌数据库的数据库文件保存位置，默认为${DATA_HOME}/postgresql，即默认的应用数据目录下的postgresql目录。注：如果更改该目录，该路径目录必须为空目录，否则会导致数据库无法启动。
jdbc.url	默认是：jdbc:postgresql://localhost:9601/sward_ee?stringtype=unspecified 其中 9601 为端口号，sward_ee 为数据库名字，这两个可更改但是端口号必须与postgresql.db.port 保持一致数据库名字必须与postgresql.database 保持一致
jdbc.username	数据库登录名，必须与postgresql.db.username一致
jdbc.password	数据库登录密码，必须与postgresql.db.password一致

3.3 统一登录

统一登录，即使用统一使用Soular的用户，部门等，这样配置可以让一个用户同时使用多个应用。需要安装Soular，具体安装见Soular 文档。

#soular
auth:
type: local
soular:
address: http://soular.tiklab.net
expire: 86400

属性	说明
type	local:本地登录 soular:统一登录。配置文件中默认为local
address	配置统一登录时需更改address为soular地址，http://ip:9100，IP为安装soular的机器IP